# 先把控件理解成什么

控件是玩家在页面里直接看到、直接点击或直接操作的内容。

常见的控件用途包括：

• 显示一条信息
• 触发一次点击效果
• 打开一组子控件
• 展示某个数值进度
• 直接修改一个属性值
• 作为聊天、排行、地图、AI 等入口

# 当前控件编辑区分成哪几块

当前控件编辑页主要分成这几块：

# 控件类型决定它长什么样

在“显示 / 布局”里，最重要的一项就是 控件类型。

当前可见的常见类型有：

控件类型	适合做什么
默认	普通按钮或普通信息块
按钮靠左 / 按钮放底部 / 按钮放中间 / 按钮放上面	调整按钮区位置
控件容器	让一组子控件直接显示在这个控件内部
控件容器(弹窗)	点击后弹出一组子控件
控件容器(折叠)	点击后展开或收起子控件
特殊：进度条 / 特殊：环形进度条	把数值显示成进度
快捷：数字输入框	直接输入数值
快捷：数字滑动条	拖动修改数值
快捷：开关	在两个值之间切换

# 容器类控件最适合用来整理界面

当一个控件被设成容器后，它就不只是“自己做一件事”，还可以继续装下别的控件。

当前这几种容器类型都可以继续添加：

• 子控件
• 子菜单
• 返回按钮
• 弹窗保留相关设置

# 进度条、输入框、开关更像“直接操作值”

有些控件类型的重点已经不再是“点一下执行一次”，而是“直接改值”。

类型	需要设置什么
进度条 / 环形进度条	主属性、上限属性、进度颜色
数字输入框 / 数字滑动条	绑定属性、最小值、步长、最大值
开关	绑定属性、关闭值、开启值

这类控件很适合做：

• 音量调节
• 数值分配
• 模式切换
• 状态显示

# 一个控件还能决定很多显示细节

除了控件类型，当前控件还可以继续设置这些显示项：

• 按钮文字
• 按钮提示
• 成功反馈
• 失败反馈
• 是否隐藏
• 是否始终显示
• 点击后关闭弹窗
• 是否显示结果弹窗
• 是否禁用详情
• 详情里是否显示点击次数

如果你想让一个控件更像“完整的页面部件”，这些内容通常都要一起设置。

# 高级区里还有什么

“高级”里现在主要能设置：

• 延迟触发
• 冷却
• 全局冷却
• 触发上限
• 点击跳转场景
• 在其他场景里也显示
• 详情文本
• 弹窗音效
• 点击音效
• 二次确认
• 脚本入口
• 插件模式

# 插件模式会把控件变成特殊入口

在高级区底部，当前控件还可以直接切换成这些模式：

• 聊天(个人)
• 聊天(系统)
• 聊天(全部)
• 排行
• 邮箱
• 商店
• 成就
• 地图
• AI智能体

其中 地图 和 AI智能体 还会继续要求你选择绑定目标。

# 一个常见理解顺序

如果你正在做一个新控件，可以按这个顺序理解它：

1. 它出现在哪个场景
2. 它是普通按钮，还是容器 / 进度条 / 输入控件
3. 玩家点它以后会发生什么
4. 它是否需要显示成功 / 失败反馈
5. 它是否还要挂冷却、详情、脚本或插件模式

# 下一页

继续看 自定义控件。