使用指南
Cocos 组件 / UI / Slider节点
Cocos 组件 / UI / Slider 节点手册，包含 7 个节点的用途、引脚、使用场景和注意事项。
16
学习目标
访问 Cocos Creator 组件的属性、方法和事件，把引擎能力转成可视化工作流。
覆盖范围
- 节点数量：7
- 分类路径：Cocos 组件 / UI / Slider
典型使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
通用注意事项
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
- 部分组件能力受 Cocos Creator 版本限制，页面会标出版本字段。
节点索引
| 节点 | 节点 ID | 输入/输出 | 执行方式 |
|---|---|---|---|
| 滑动事件 | sliderSlideBind | 3 / 2 | 立即继续 |
| 获取当前进度 | sliderGetProgress | 1 / 1 | 立即继续 |
| 获取滑动方向 | sliderGetDirection | 1 / 1 | 立即继续 |
| 获取滑块 Sprite | sliderGetHandle | 1 / 1 | 立即继续 |
| 设置当前进度 | sliderSetProgress | 3 / 2 | 立即继续 |
| 设置滑动方向 | sliderSetDirection | 3 / 2 | 立即继续 |
| 设置滑块 Sprite | sliderSetHandle | 3 / 2 | 立即继续 |
滑动事件
绑定滑动事件：当滑块被拖拽时触发关联的 执行事件 节点。 典型用途：拖拽音量滑块时实时调整音效、滑动亮度条时即时更新画面。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sliderSlideBind |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Slider |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | - | - | 可选 |
event | 事件 | 事件 | 事件 | 事件入口 连接到执行事件节点的事件输出引脚 | - | 必填 |
slider | 滑块 | 数据 | cc.Component / Slider | 目标滑块 要监听滑动事件的 Slider 组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | - | - | 可选 |
handle | 句柄 | 数据 | eventHandle | 绑定句柄 用于后续取消这个具体监听。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取当前进度
获取当前进度：返回滑块的当前进度值。 取值范围：0（最小值）~ 1（最大值）。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sliderGetProgress |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Slider |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
slider | 滑块 | 数据 | cc.Component / Slider | 目标滑块 要操作的 Slider 组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
progress | 进度 | 数据 | number | 当前进度 0=最小值，1=最大值 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取滑动方向
获取滑动方向：返回滑块当前的拖拽方向。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sliderGetDirection |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Slider |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
slider | 滑块 | 数据 | cc.Component / Slider | 目标滑块 要操作的 Slider 组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
direction | 方向 | 数据 | number | 滑动方向 水平（=0）：从左到右 垂直（=1）：从下到上 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取滑块 Sprite
获取滑块 Sprite：返回 Slider 中用于拖拽控制的 Sprite 组件。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sliderGetHandle |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Slider |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
slider | 滑块 | 数据 | cc.Component / Slider | 目标滑块 要操作的 Slider 组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
handle | Sprite | 数据 | cc.Component / Sprite | 滑块 Sprite 用于拖拽控制的 Sprite 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置当前进度
设置当前进度：设置滑块的当前进度值。 取值范围：0（最小值）~ 1（最大值）。 典型用途：音量滑块设为 0.8（80% 音量）、血量条设为 0.5（50% 生命值）。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sliderSetProgress |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Slider |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
slider | 滑块 | 数据 | cc.Component / Slider | 目标滑块 要操作的 Slider 组件 | - | 必填 |
progress | 进度 | 数据 | number | 当前进度 有效区间为 0~1 | 输入框 默认值：0 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
slider | 滑块 | 数据 | cc.Component / Slider | 目标滑块 要操作的 Slider 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置滑动方向
设置滑动方向：更改滑块的拖拽方向。 水平适合用作进度条、音量条；垂直适合用作高度调节、强度条。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sliderSetDirection |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Slider |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
slider | 滑块 | 数据 | cc.Component / Slider | 目标滑块 要操作的 Slider 组件 | - | 必填 |
direction | 方向 | 数据 | number | 滑动方向 水平（=0）：从左到右 垂直（=1）：从下到上 | 下拉选择 默认值：0 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
slider | 滑块 | 数据 | cc.Component / Slider | 目标滑块 要操作的 Slider 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置滑块 Sprite
设置滑块 Sprite：更换 Slider 中用于拖拽控制的 Sprite 组件。 典型用途：自定义滑块外观。传入 null 可清空滑块图片。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | sliderSetHandle |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Slider |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
slider | 滑块 | 数据 | cc.Component / Slider | 目标滑块 要操作的 Slider 组件 | - | 必填 |
handle | Sprite | 数据 | cc.Component / Sprite | 滑块 Sprite 用于拖拽的 Sprite 组件，传入 null 可清空 | - | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
slider | 滑块 | 数据 | cc.Component / Slider | 目标滑块 要操作的 Slider 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。