docs: 按 Godot 规范优化全部 GDScript 注释

- 类/信号/方法添加 ## 文档注释与 @param 标签
- 清理 pass 占位残留
This commit is contained in:
2026-08-03 22:25:43 +08:00
parent 19f81ceeec
commit 782b1f1701
8 changed files with 115 additions and 23 deletions
+14
View File
@@ -1,5 +1,9 @@
## 存档槽位条目(挂载于 SaveSlot.tscn)。
## 展示单个存档信息;空槽位用于新建存档。
extends PanelContainer
## 槽位被点击时发出,save_id 为空表示点击了新建槽位。
## @param save_id: 存档 ID
signal slot_pressed(save_id: String)
@onready var slot_index_label: Label = %SlotIndexLabel
@@ -9,9 +13,16 @@ signal slot_pressed(save_id: String)
@onready var delete_button: Button = %DeleteButton
@onready var arrow_button: Button = %ArrowIcon
## 本槽位对应的存档 ID。
var save_id: String = ""
## 是否已有存档数据(false 表示新建槽位)。
var has_data: bool = false
## 填充为已有存档槽位。
## @param id: 存档 ID
## @param name_text: 存档名称
## @param meta1: 第一行元数据
## @param meta2: 第二行元数据
func setup(id: String, name_text: String, meta1: String, meta2: String) -> void:
save_id = id
has_data = true
@@ -22,6 +33,7 @@ func setup(id: String, name_text: String, meta1: String, meta2: String) -> void:
delete_button.visible = true
arrow_button.visible = true
## 填充为"新建存档"空槽位。
func setup_empty() -> void:
has_data = false
slot_index_label.text = "+"
@@ -31,8 +43,10 @@ func setup_empty() -> void:
delete_button.visible = false
arrow_button.visible = false
## 槽位本体被点击。
func _on_pressed() -> void:
slot_pressed.emit(save_id)
## 点击删除按钮(TODO:接入确认弹窗)。
func _on_delete_button_button_up() -> void:
print("删除存档: ", save_id)