# 控件字段参考

# 入口与身份

在场景中选择控件，先记录控件 ID 和所属场景。名称、别名可以修改，ID 用于脚本、绑定和对象行引用，不应随意重建。

# 编辑区域

区域	主要字段	作用
基础	名称、别名、简介、图标、分类	玩家可见内容和检索
显示/布局	控件类型、容器、位置、显示条件	结构和显示
转化	需求、玩家/对象花费、获得	点击后的规则
对象	绑定类、当前对象、对象内容	将控件绑定实例
高级	冷却、延迟、次数、跳转、确认	触发约束
脚本	只读、点击、进入/离开等挂载点	自定义规则或表现
插件	聊天、排行、商店、地图、AI 等	转换为平台入口

# 类型与执行

普通按钮执行点击规则；容器负责子控件显示；进度条读取属性；数字输入、滑动条和开关直接写入绑定属性。显示隐藏只影响渲染，不会自动禁用已触发的脚本。

# 运行时链路

解析控件和对象上下文
  → 判断显示/可用状态
  → 收集玩家输入或确认
  → 校验需求和全部花费
  → 只运行一次权威动作路径
  → 提交获得/插件结果
  → 显示反馈并按需保存

指针挂载点、Canvas binding 和插件入口可能从不同脚本槽进入，但不能为同一个语义动作再造一条结算路径。

# 每类责任只能有一个所有者

责任	推荐所有者
控件是否显示	只读显示/需求规则
动作是否允许	需求与动作最终校验
花费和奖励	转化字段或一个动作脚本，不能重复
当前重复实例	对象上下文和稳定对象 ID
布局与响应式	渲染布局/控件结构
视觉和声音反馈	权威结果后的客户端特效/音频
跨玩家/平台状态	插件或平台 API

# 字段冲突

同一动作同时配置转化字段和点击脚本时，必须明确谁负责扣除和发放。插件控件的内部提交由插件负责，不要在外层脚本重复调用。对象控件必须处理当前对象为空、对象已销毁和列表重排。

# 常见失败

现象	优先检查
控件看起来禁用但仍执行	视觉样式与运行时需求是否不同
一次点击结算两次	DOM 动作、指针挂载点或 Canvas binding 是否重复触发
修改错误对象行	是否把对象身份保存成下标/名称
取消确认后仍继续	取消分支是否真正终止动作链
冷却意外重置	冷却是否只存在于临时 UI 状态
改类型后布局破坏	子结构或样式槽是否与新类型不兼容

# 迁移与验收

迁移布局时保留控件 ID 和脚本；修改类型后重新检查子控件和绑定。验收显示条件、点击一次、冷却、弹窗关闭、输入边界、对象切换、插件入口和窄屏布局。

下一页：自定义控件。