使用指南
Cocos 组件 / UI / Button节点
Cocos 组件 / UI / Button 节点手册，包含 25 个节点的用途、引脚、使用场景和注意事项。
16
学习目标
访问 Cocos Creator 组件的属性、方法和事件，把引擎能力转成可视化工作流。
覆盖范围
- 节点数量：25
- 分类路径：Cocos 组件 / UI / Button
典型使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
通用注意事项
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
- 部分组件能力受 Cocos Creator 版本限制，页面会标出版本字段。
节点索引
| 节点 | 节点 ID | 输入/输出 | 执行方式 |
|---|---|---|---|
| 绑定点击事件 | buttonClickBind | 3 / 2 | 立即继续 |
| 获取按下精灵帧 | buttonGetPressedSprite | 1 / 1 | 立即继续 |
| 获取按下颜色 | buttonGetPressedColor | 1 / 1 | 立即继续 |
| 获取过渡类型 | buttonGetTransition | 1 / 1 | 立即继续 |
| 获取禁用精灵帧 | buttonGetDisabledSprite | 1 / 1 | 立即继续 |
| 获取禁用颜色 | buttonGetDisabledColor | 1 / 1 | 立即继续 |
| 获取可交互 | buttonGetInteractable | 1 / 1 | 立即继续 |
| 获取缩放比例 | buttonGetZoomScale | 1 / 1 | 立即继续 |
| 获取所有属性 | buttonGetProperties | 1 / 11 | 立即继续 |
| 获取悬停精灵帧 | buttonGetHoverSprite | 1 / 1 | 立即继续 |
| 获取悬停颜色 | buttonGetHoverColor | 1 / 1 | 立即继续 |
| 获取正常精灵帧 | buttonGetNormalSprite | 1 / 1 | 立即继续 |
| 获取正常颜色 | buttonGetNormalColor | 1 / 1 | 立即继续 |
| 设置按下精灵帧 | buttonSetPressedSprite | 3 / 2 | 立即继续 |
| 设置按下颜色 | buttonSetPressedColor | 3 / 2 | 立即继续 |
| 设置过渡类型 | buttonSetTransition | 3 / 2 | 立即继续 |
| 设置禁用精灵帧 | buttonSetDisabledSprite | 3 / 2 | 立即继续 |
| 设置禁用颜色 | buttonSetDisabledColor | 3 / 2 | 立即继续 |
| 设置可交互 | buttonSetInteractable | 3 / 2 | 立即继续 |
| 设置缩放比例 | buttonSetZoomScale | 3 / 2 | 立即继续 |
| 设置所有属性 | buttonSetProperties | 13 / 2 | 立即继续 |
| 设置悬停精灵帧 | buttonSetHoverSprite | 3 / 2 | 立即继续 |
| 设置悬停颜色 | buttonSetHoverColor | 3 / 2 | 立即继续 |
| 设置正常精灵帧 | buttonSetNormalSprite | 3 / 2 | 立即继续 |
| 设置正常颜色 | buttonSetNormalColor | 3 / 2 | 立即继续 |
绑定点击事件
绑定点击事件：绑定按钮的点击事件，按钮被点击时触发关联的 执行事件 节点。 典型用途：点击按钮后播放音效、打开商店面板、触发剧情对话、切换场景等。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | buttonClickBind |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Button |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 触发绑定按钮点击事件 | - | 可选 |
event | 事件 | 事件 | 事件 | 事件入口 连接到执行事件节点的事件输出引脚 | - | 必填 |
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 要监听点击事件的 Button 组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | - | - | 可选 |
handle | 句柄 | 数据 | eventHandle | 绑定句柄 用于后续取消这个具体监听。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取按下精灵帧
获取按下精灵帧：获取按钮按下时显示的精灵图片。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | buttonGetPressedSprite |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Button |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
spriteFrame | 精灵帧 | 数据 | cc.Asset / SpriteFrame | 按下精灵帧 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取按下颜色
获取按下颜色：返回按钮在按下状态（点击但未释放时）下的颜色。 典型用途：提供点击触感反馈，让玩家知道按钮已被按下。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | buttonGetPressedColor |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Button |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
color | 颜色 | 数据 | color | 按下颜色 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取过渡类型
获取过渡类型：返回按钮当前的点击反馈模式。 过渡类型（0=无过渡、1=颜色过渡、2=精灵过渡、3=缩放过渡）决定按钮在按下/悬停/禁用时的外观变化方式。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | buttonGetTransition |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Button |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 要获取过渡类型的 Button 组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
transition | 过渡类型 | 数据 | number | 过渡类型 无过渡（=0）：不做任何变化 颜色过渡（=1）：改变按钮颜色 精灵过渡（=2）：切换按钮精灵图片 缩放过渡（=3）：按下时缩放按钮大小 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取禁用精灵帧
获取禁用精灵帧：获取按钮禁用时显示的精灵图片。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | buttonGetDisabledSprite |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Button |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
spriteFrame | 精灵帧 | 数据 | cc.Asset / SpriteFrame | 禁用精灵帧 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取禁用颜色
获取禁用颜色：返回按钮在禁用（interactable=false）状态下的颜色。 典型用途：用灰色调提示玩家该按钮当前不可用。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | buttonGetDisabledColor |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Button |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
color | 颜色 | 数据 | color | 禁用颜色 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取可交互
获取可交互状态：返回按钮当前是否可被玩家点击。 值为 true 时可正常点击，false 时禁止交互。典型用途：检测技能按钮是否在冷却中、判断购买按钮是否可用。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | buttonGetInteractable |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Button |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 要获取可交互状态的 Button 组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
interactable | 可交互 | 数据 | boolean | 可交互状态 值为 true 时可点击，false 时禁止交互 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取缩放比例
获取缩放比例：返回按钮按下时的缩放值（仅在 SCALE 过渡模式下生效）。 值为 1.0 表示不缩放，0.8 表示按下时缩小到 80%。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | buttonGetZoomScale |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Button |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 要获取缩放比例的 Button 组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
zoomScale | 缩放比例 | 数据 | number | 缩放比例 按下时的缩放比例 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取所有属性
一次性读出按钮的全部常用属性：可交互状态、过渡类型、缩放比例、四种状态颜色和四种状态精灵帧。无需逐个连接 12 个 获取类节点。 典型用途：调试时快速检测按钮全部状态，或保存按钮快照以便后续批量修改对比。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | buttonGetProperties |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Button |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 要读取属性的 Button 组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
interactable | 可交互 | 数据 | boolean | 可交互状态 值为 true 时可点击，false 时禁止交互 | - | 可选 |
transition | 过渡类型 | 数据 | number | 过渡类型 无过渡（=0）：无变化 颜色过渡（=1）：改变颜色 精灵过渡（=2）：切换精灵 缩放过渡（=3）：缩放按钮 | - | 可选 |
zoomScale | 缩放比例 | 数据 | number | 缩放比例 按下时的缩放值，1.0=不缩放 | - | 可选 |
normalColor | 正常颜色 | 数据 | color | 正常颜色 正常状态下的颜色 | - | 可选 |
pressedColor | 按下颜色 | 数据 | color | 按下颜色 按下状态下的颜色 | - | 可选 |
hoverColor | 悬停颜色 | 数据 | color | 悬停颜色 悬停状态下的颜色 | - | 可选 |
disabledColor | 禁用颜色 | 数据 | color | 禁用颜色 禁用状态下的颜色 | - | 可选 |
normalSprite | 正常精灵帧 | 数据 | cc.Asset / SpriteFrame | 正常精灵帧 默认状态下的精灵图片 | - | 可选 |
pressedSprite | 按下精灵帧 | 数据 | cc.Asset / SpriteFrame | 按下精灵帧 按下时的精灵图片 | - | 可选 |
hoverSprite | 悬停精灵帧 | 数据 | cc.Asset / SpriteFrame | 悬停精灵帧 悬停时的精灵图片 | - | 可选 |
disabledSprite | 禁用精灵帧 | 数据 | cc.Asset / SpriteFrame | 禁用精灵帧 禁用时的精灵图片 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取悬停精灵帧
获取悬停精灵帧：获取鼠标悬停时按钮显示的精灵图片。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | buttonGetHoverSprite |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Button |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
spriteFrame | 精灵帧 | 数据 | cc.Asset / SpriteFrame | 悬停精灵帧 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取悬停颜色
获取悬停颜色：返回按钮在鼠标悬停（未点击）时的颜色。 典型用途：鼠标悬停时颜色变亮，提示玩家该按钮可交互。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | buttonGetHoverColor |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Button |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
color | 颜色 | 数据 | color | 悬停颜色 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取正常精灵帧
获取正常精灵帧：获取按钮在默认状态下显示的精灵图片。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | buttonGetNormalSprite |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Button |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
spriteFrame | 精灵帧 | 数据 | cc.Asset / SpriteFrame | 正常精灵帧 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取正常颜色
获取正常颜色：返回按钮在正常状态（未被点击、悬停或禁用）下的颜色。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | buttonGetNormalColor |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Button |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
color | 颜色 | 数据 | color | 正常颜色 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置按下精灵帧
设置按下精灵帧：更换按钮按下时显示的精灵图片。 典型用途：点击按钮时显示凹陷或发光效果。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | buttonSetPressedSprite |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Button |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 | - | 必填 |
spriteFrame | 精灵帧 | 数据 | cc.Asset / SpriteFrame | 按下精灵帧 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置按下颜色
设置按下颜色：设置 Button 在按下状态下的颜色。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | buttonSetPressedColor |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Button |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 | - | 必填 |
color | 颜色 | 数据 | color | 按下颜色 | 可编辑控件 默认值：[200,200,200,255] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置过渡类型
设置过渡类型：更改按钮的点击反馈模式。 颜色过渡（1）适合简单的纯色按钮，精灵过渡（2）适合自定义图片按钮，缩放过渡（3）适合纯文字按钮。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | buttonSetTransition |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Button |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 要设置过渡类型的 Button 组件 | - | 必填 |
transition | 过渡类型 | 数据 | number | 过渡类型 无过渡（=0）：无变化 颜色过渡（=1）：改变按钮颜色 精灵过渡（=2）：切换按钮精灵图片 缩放过渡（=3）：按下时缩放按钮 | 下拉选择 默认值：0 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置禁用精灵帧
设置禁用精灵帧：更换按钮禁用时显示的精灵图片。 典型用途：禁用时显示变灰或半透明图片表示不可用。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | buttonSetDisabledSprite |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Button |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 | - | 必填 |
spriteFrame | 精灵帧 | 数据 | cc.Asset / SpriteFrame | 禁用精灵帧 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置禁用颜色
设置禁用颜色：设置按钮在禁用（interactable=false）状态下的颜色。 典型用途：灰色调按钮提示玩家暂不可用。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | buttonSetDisabledColor |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Button |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 | - | 必填 |
color | 颜色 | 数据 | color | 禁用颜色 | 可编辑控件 默认值：[120,120,120,200] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置可交互
设置可交互状态：控制按钮是否可被玩家点击。 设为 false 可禁用按钮（如冷却中的技能按钮、已售罄的商品），设为 true 恢复点击。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | buttonSetInteractable |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Button |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 要设置可交互状态的 Button 组件 | - | 必填 |
interactable | 可交互 | 数据 | boolean | 可交互状态 是否可交互 | 开关 默认值：true | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置缩放比例
设置缩放比例：设置按钮按下时的缩放值（仅在 SCALE 过渡模式下生效）。 常用值：0.9（缩小 10%）、1.1（放大 10%）。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | buttonSetZoomScale |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Button |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 要设置缩放比例的 Button 组件 | - | 必填 |
zoomScale | 缩放比例 | 数据 | number | 缩放比例 按下时的缩放比例 | 输入框 默认值：1.2 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置所有属性
一次性批量修改按钮的多个常用属性。 公开引脚语义（重要）：除 exe 与 button 外，所有可写属性引脚默认不公开（isPublic: false），只有被显式公开的引脚才参与写入。若想保留目标属性原值不变，必须保持引脚不公开——仅断开连线不够，已公开的引脚会用内联控件默认值覆盖原值。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | buttonSetProperties |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Button |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 要修改属性的 Button 组件 | - | 必填 |
interactable | 可交互 | 数据 | boolean | 可交互状态 是否可交互。默认不公开；公开后才参与写入。 | 开关 默认值：true | 可选 默认隐藏 |
transition | 过渡类型 | 数据 | number | 过渡类型 0=NONE, 1=COLOR, 2=SPRITE, 3=SCALE。默认不公开；公开后才参与写入。 | 下拉选择 默认值：0 | 可选 默认隐藏 |
zoomScale | 缩放比例 | 数据 | number | 缩放比例 按下时的缩放比例。默认不公开；公开后才参与写入。 | 输入框 默认值：1.2 | 可选 默认隐藏 |
normalColor | 正常颜色 | 数据 | color | 正常颜色 正常状态下的颜色。默认不公开；公开后才参与写入。 | 可编辑控件 默认值：[255,255,255,255] | 可选 默认隐藏 |
pressedColor | 按下颜色 | 数据 | color | 按下颜色 按下状态下的颜色。默认不公开；公开后才参与写入。 | 可编辑控件 默认值：[200,200,200,255] | 可选 默认隐藏 |
hoverColor | 悬停颜色 | 数据 | color | 悬停颜色 悬停状态下的颜色。默认不公开；公开后才参与写入。 | 可编辑控件 默认值：[255,255,255,255] | 可选 默认隐藏 |
disabledColor | 禁用颜色 | 数据 | color | 禁用颜色 禁用状态下的颜色。默认不公开；公开后才参与写入。 | 可编辑控件 默认值：[120,120,120,200] | 可选 默认隐藏 |
normalSprite | 正常精灵帧 | 数据 | cc.Asset / SpriteFrame | 正常精灵帧 正常状态下的精灵帧。默认不公开；公开后才参与写入。 | - | 可选 默认隐藏 |
pressedSprite | 按下精灵帧 | 数据 | cc.Asset / SpriteFrame | 按下精灵帧 按下状态下的精灵帧。默认不公开；公开后才参与写入。 | - | 可选 默认隐藏 |
hoverSprite | 悬停精灵帧 | 数据 | cc.Asset / SpriteFrame | 悬停精灵帧 悬停状态下的精灵帧。默认不公开；公开后才参与写入。 | - | 可选 默认隐藏 |
disabledSprite | 禁用精灵帧 | 数据 | cc.Asset / SpriteFrame | 禁用精灵帧 禁用状态下的精灵帧。默认不公开；公开后才参与写入。 | - | 可选 默认隐藏 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
button | 按钮 | 数据 | cc.Component / Button | 目标按钮（透传） | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置悬停精灵帧
设置悬停精灵帧：更换鼠标悬停时按钮显示的精灵图片。 典型用途：悬停时显示高亮或放大效果。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | buttonSetHoverSprite |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Button |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 | - | 必填 |
spriteFrame | 精灵帧 | 数据 | cc.Asset / SpriteFrame | 悬停精灵帧 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置悬停颜色
设置悬停颜色：设置 Button 在悬停状态下的颜色。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | buttonSetHoverColor |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Button |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 | - | 必填 |
color | 颜色 | 数据 | color | 悬停颜色 | 可编辑控件 默认值：[255,255,255,255] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置正常精灵帧
设置正常精灵帧：更换按钮在默认状态下显示的精灵图片。 典型用途：为动态按钮更换普通状态贴图。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | buttonSetNormalSprite |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Button |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 | - | 必填 |
spriteFrame | 精灵帧 | 数据 | cc.Asset / SpriteFrame | 正常精灵帧 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置正常颜色
设置正常颜色：设置按钮在正常状态（未被点击、悬停或禁用）下的颜色。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | buttonSetNormalColor |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Button |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 | - | 必填 |
color | 颜色 | 数据 | color | 正常颜色 | 可编辑控件 默认值：[255,255,255,255] | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
button | 按钮 | 数据 | cc.Component / Button | 目标按钮 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。