使用指南
Cocos 组件 / UI / ScrollView节点
Cocos 组件 / UI / ScrollView 节点手册，包含 33 个节点的用途、引脚、使用场景和注意事项。
16
学习目标
访问 Cocos Creator 组件的属性、方法和事件，把引擎能力转成可视化工作流。
覆盖范围
- 节点数量：33
- 分类路径：Cocos 组件 / UI / ScrollView
典型使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
通用注意事项
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
- 部分组件能力受 Cocos Creator 版本限制，页面会标出版本字段。
节点索引
| 节点 | 节点 ID | 输入/输出 | 执行方式 |
|---|---|---|---|
| 滚动到底部 | scrollViewScrollToBottom | 4 / 2 | 立即继续 |
| 滚动到顶部 | scrollViewScrollToTop | 4 / 2 | 立即继续 |
| 滚动到偏移 | scrollViewScrollToOffset | 5 / 2 | 立即继续 |
| 滚动到右侧 | scrollViewScrollToRight | 4 / 2 | 立即继续 |
| 滚动到左侧 | scrollViewScrollToLeft | 4 / 2 | 立即继续 |
| 获取垂直滚动 | scrollViewGetVertical | 1 / 1 | 立即继续 |
| 获取垂直滚动条 | scrollViewGetVerticalScrollBar | 1 / 1 | 立即继续 |
| 获取弹性 | scrollViewGetElastic | 1 / 1 | 立即继续 |
| 获取惯性 | scrollViewGetInertia | 1 / 1 | 立即继续 |
| 获取滚动偏移 | scrollViewGetScrollOffset | 1 / 1 | 立即继续 |
| 获取回弹时长 | scrollViewGetBounceDuration | 1 / 1 | 立即继续 |
| 获取内容节点 | scrollViewGetContent | 1 / 1 | 立即继续 |
| 获取取消子事件 | scrollViewGetCancelInnerEvents | 1 / 1 | 立即继续 |
| 获取水平滚动 | scrollViewGetHorizontal | 1 / 1 | 立即继续 |
| 获取水平滚动条 | scrollViewGetHorizontalScrollBar | 1 / 1 | 立即继续 |
| 获取所有属性 | scrollViewGetProperties | 1 / 10 | 立即继续 |
| 获取制动系数 | scrollViewGetBrake | 1 / 1 | 立即继续 |
| 获取最大偏移 | scrollViewGetMaxScrollOffset | 1 / 1 | 立即继续 |
| 设置垂直滚动 | scrollViewSetVertical | 3 / 2 | 立即继续 |
| 设置垂直滚动条 | scrollViewSetVerticalScrollBar | 3 / 2 | 立即继续 |
| 设置弹性 | scrollViewSetElastic | 3 / 2 | 立即继续 |
| 设置惯性 | scrollViewSetInertia | 3 / 2 | 立即继续 |
| 设置回弹时长 | scrollViewSetBounceDuration | 3 / 2 | 立即继续 |
| 设置内容节点 | scrollViewSetContent | 3 / 2 | 立即继续 |
| 设置取消子事件 | scrollViewSetCancelInnerEvents | 3 / 2 | 立即继续 |
| 设置水平滚动 | scrollViewSetHorizontal | 3 / 2 | 立即继续 |
| 设置水平滚动条 | scrollViewSetHorizontalScrollBar | 3 / 2 | 立即继续 |
| 设置所有属性 | scrollViewSetProperties | 12 / 2 | 立即继续 |
| 设置制动系数 | scrollViewSetBrake | 3 / 2 | 立即继续 |
| 是否正在滚动 | scrollViewIsScrolling | 1 / 1 | 立即继续 |
| 是否自动滚动 | scrollViewIsAutoScrolling | 1 / 1 | 立即继续 |
| 停止自动滚动 | scrollViewStopAutoScroll | 2 / 2 | 立即继续 |
| ScrollView 事件 | scrollViewEventBind | 4 / 2 | 立即继续 |
滚动到底部
滚动到底部：以动画方式平滑滚动到内容的底部。 典型用途：聊天框中收到新消息时自动滚动到最新消息；或下拉刷新结束后回到底部。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | scrollViewScrollToBottom |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | ScrollView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 必填 |
timeInSecond | 动画时长 | 数据 | number | 动画时长 滚动动画的持续时间（秒） | 输入框 默认值：0.3 | 可选 |
attenuated | 缓动 | 数据 | boolean | 缓动 是否使用缓动效果（默认 true） | 开关 默认值：true | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
滚动到顶部
滚动到顶部：以动画方式平滑滚动到内容的顶部。 典型用途：在聊天框中收到新消息后自动滚动到底部（此处为顶部，取决于布局）的逆操作，或点击”回到顶部”按钮时使用。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | scrollViewScrollToTop |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | ScrollView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 必填 |
timeInSecond | 动画时长 | 数据 | number | 动画时长 滚动动画的持续时间（秒） | 输入框 默认值：0.3 | 可选 |
attenuated | 缓动 | 数据 | boolean | 缓动 是否使用缓动效果（默认 true） | 开关 默认值：true | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
滚动到偏移
滚动到指定偏移：以动画方式平滑滚动到指定的偏移位置。 目标偏移以 Vec2 传入，可通过减法计算相对当前位置的偏移量。 典型用途：在分页列表中滚动到指定索引项（需先计算该项的偏移量）。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | scrollViewScrollToOffset |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | ScrollView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 必填 |
offset | 偏移 | 数据 | vector2 | 目标偏移 要滚动到的目标偏移量 | - | 必填 |
timeInSecond | 动画时长 | 数据 | number | 动画时长 滚动动画的持续时间（秒） | 输入框 默认值：0.3 | 可选 |
attenuated | 缓动 | 数据 | boolean | 缓动 是否使用缓动效果（默认 true） | 开关 默认值：true | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
滚动到右侧
滚动到右侧：以动画方式平滑滚动到内容的最右侧。 典型用途：在横向滑动教程中自动滚动到下一页末尾。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | scrollViewScrollToRight |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | ScrollView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 必填 |
timeInSecond | 动画时长 | 数据 | number | 动画时长 滚动动画的持续时间（秒） | 输入框 默认值：0.3 | 可选 |
attenuated | 缓动 | 数据 | boolean | 缓动 是否使用缓动效果（默认 true） | 开关 默认值：true | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
滚动到左侧
滚动到左侧：以动画方式平滑滚动到内容的左侧起始位置。 典型用途：在横向滚动关卡地图中点击”回到起点”按钮时使用。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | scrollViewScrollToLeft |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | ScrollView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 必填 |
timeInSecond | 动画时长 | 数据 | number | 动画时长 滚动动画的持续时间（秒） | 输入框 默认值：0.3 | 可选 |
attenuated | 缓动 | 数据 | boolean | 缓动 是否使用缓动效果（默认 true） | 开关 默认值：true | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取垂直滚动
获取垂直滚动开关：返回 ScrollView 是否启用了垂直方向滚动。 典型用途：判断列表当前是否允许上下滑动。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | scrollViewGetVertical |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | ScrollView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
vertical | 垂直滚动 | 数据 | boolean | 垂直滚动 是否启用垂直滚动 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取垂直滚动条
获取垂直滚动条：返回 ScrollView 关联的垂直滚动条组件。 典型用途：获取滚动条后调整其颜色或大小以匹配 UI 主题。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | scrollViewGetVerticalScrollBar |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | ScrollView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
verticalScrollBar | 垂直滚动条 | 数据 | cc.Component / ScrollBar | 垂直滚动条 关联的垂直 ScrollBar 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取弹性
获取弹性开关：返回 ScrollView 是否启用弹性回弹。 启用后，滚动到边界时内容会超出边界并回弹，提供越界反馈。 典型用途：在列表末端让玩家感受到”到底了”的视觉反馈。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | scrollViewGetElastic |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | ScrollView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
elastic | 弹性 | 数据 | boolean | 弹性开关 是否启用弹性回弹 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取惯性
获取惯性开关：返回 ScrollView 是否启用惯性滚动。 启用后，松手后内容会继续滑动一段距离再停止，手感更顺滑。 典型用途：判断列表是否有”甩动”效果。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | scrollViewGetInertia |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | ScrollView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
inertia | 惯性 | 数据 | boolean | 惯性开关 是否启用惯性滚动 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取滚动偏移
获取滚动偏移：返回 ScrollView 当前的滚动偏移量。 x 为水平偏移，y 为垂直偏移，单位与内容节点坐标系一致。 典型用途：判断当前滚动位置以实现无限加载（接近底部时加载更多数据）。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | scrollViewGetScrollOffset |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | ScrollView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
offset | 偏移 | 数据 | vector2 | 滚动偏移 当前的滚动偏移量 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取回弹时长
获取回弹时长：返回 ScrollView 的弹性回弹持续时间（秒）。 取值范围 0~10 秒，仅在弹性回弹开启时有效。 典型用途：回弹时长设为 0.3 秒让列表回弹干脆利落，设为 1 秒则更柔和。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | scrollViewGetBounceDuration |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | ScrollView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
bounceDuration | 回弹时长 | 数据 | number | 回弹时长 弹性回弹持续时间（秒，0~10），仅在 elastic=true 时有效 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取内容节点
获取内容节点：返回 ScrollView 的可滚动内容节点。 内容节点的父节点应作为视口区域使用。 典型用途：获取列表内容节点后动态添加/移除列表项。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | scrollViewGetContent |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | ScrollView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
content | 内容节点 | 数据 | cc.Node | 内容节点 ScrollView 的可滚动内容节点 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取取消子事件
获取取消子节点事件开关：返回 ScrollView 在滚动时是否取消子节点的触摸事件。 启用后可防止滚动干扰子节点的点击/拖拽。 注意：子节点的 touchstart 仍可能触发；短距离触摸下 touchmove/touchend 行为也存在例外。 典型用途：在列表中同时存在可点击按钮时，避免滚动误触。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | scrollViewGetCancelInnerEvents |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | ScrollView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
cancelInnerEvents | 取消子事件 | 数据 | boolean | 取消子节点事件 滚动时是否取消子节点的触摸事件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取水平滚动
获取水平滚动开关：返回 ScrollView 是否启用了水平方向滚动。 典型用途：判断列表是否允许左右滑动。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | scrollViewGetHorizontal |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | ScrollView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
horizontal | 水平滚动 | 数据 | boolean | 水平滚动 是否启用水平滚动 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取水平滚动条
获取水平滚动条：返回 ScrollView 关联的水平滚动条组件。 典型用途：获取滚动条后调整其颜色或大小以匹配 UI 主题。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | scrollViewGetHorizontalScrollBar |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | ScrollView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
horizontalScrollBar | 水平滚动条 | 数据 | cc.Component / ScrollBar | 水平滚动条 关联的水平 ScrollBar 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取所有属性
一次性读出 ScrollView 的全部常用属性：内容节点、滚动方向、惯性与制动、弹性回弹、滚动条引用、取消子事件等。等同于连接多个 获取类节点，但只用一个节点即可。适合序列化、调试、批量比较等场景。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | scrollViewGetProperties |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | ScrollView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
content | 内容节点 | 数据 | cc.Node | 内容节点 ScrollView 的可滚动内容节点。 | - | 可选 |
horizontal | 水平滚动 | 数据 | boolean | 水平滚动 是否启用水平滚动。 | - | 可选 |
vertical | 垂直滚动 | 数据 | boolean | 垂直滚动 是否启用垂直滚动。 | - | 可选 |
inertia | 惯性 | 数据 | boolean | 惯性开关 是否启用惯性滚动。 | - | 可选 |
brake | 制动系数 | 数据 | number | 制动系数 惯性制动系数（0~1），1 为立刻停止。 | - | 可选 |
elastic | 弹性 | 数据 | boolean | 弹性开关 是否启用弹性回弹。 | - | 可选 |
bounceDuration | 回弹时长 | 数据 | number | 回弹时长 弹性回弹持续时间（秒，0~10）。 | - | 可选 |
horizontalScrollBar | 水平滚动条 | 数据 | cc.Component / ScrollBar | 水平滚动条 关联的水平 ScrollBar 组件。 | - | 可选 |
verticalScrollBar | 垂直滚动条 | 数据 | cc.Component / ScrollBar | 垂直滚动条 关联的垂直 ScrollBar 组件。 | - | 可选 |
cancelInnerEvents | 取消子事件 | 数据 | boolean | 取消子节点事件 滚动时是否取消子节点的触摸事件。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取制动系数
获取制动系数：返回 ScrollView 的惯性制动系数。 取值范围 0~1，值越大停止越快，1 表示立刻停止。仅在惯性开启时有效。 典型用途：在赛车游戏道具列表中，设为较小值（如 0.2）让列表滑动更远。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | scrollViewGetBrake |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | ScrollView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
brake | 制动系数 | 数据 | number | 制动系数 惯性制动系数（0~1），1 为立刻停止 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取最大偏移
获取最大偏移：返回 ScrollView 的最大可滚动偏移量。 表示内容超出视口的部分有多少可以被滚动到。 典型用途：判断内容是否能滚动，若最大偏移为 (0, 0) 则表示内容未超出视口。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | scrollViewGetMaxScrollOffset |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | ScrollView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
maxOffset | 最大偏移 | 数据 | vector2 | 最大偏移 最大可滚动偏移量 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置垂直滚动
设置垂直滚动开关：设置 ScrollView 是否启用垂直滚动。 典型用途：在竖屏排行榜中禁用垂直滚动以锁定当前排名区域。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | scrollViewSetVertical |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | ScrollView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 必填 |
vertical | 垂直滚动 | 数据 | boolean | 垂直滚动 是否启用垂直滚动 | 开关 默认值：true | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置垂直滚动条
设置垂直滚动条：设置 ScrollView 关联的垂直滚动条组件。 传入 null 可清空绑定。 从 ScrollView 侧设置滚动条时，引擎会自动调用 ScrollBar.setScrollView(this)，这是推荐的绑定入口。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | scrollViewSetVerticalScrollBar |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | ScrollView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 必填 |
verticalScrollBar | 垂直滚动条 | 数据 | cc.Component / ScrollBar | 垂直滚动条 要关联的垂直 ScrollBar 组件，传入 null 可清空 | - | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置弹性
设置弹性开关：设置 ScrollView 是否启用弹性回弹。 启用后，滚动到边界时内容会超出边界并回弹，提供越界反馈。 典型用途：在列表末尾为玩家提供”拽过头”的橡皮筋手感。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | scrollViewSetElastic |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | ScrollView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 必填 |
elastic | 弹性 | 数据 | boolean | 弹性开关 是否启用弹性回弹 | 开关 默认值：true | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置惯性
设置惯性开关：设置 ScrollView 是否启用惯性滚动。 启用后，松手后内容会继续滑动一段距离再停止，手感更顺滑。 典型用途：为列表开启流畅的”甩动”滑动体验。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | scrollViewSetInertia |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | ScrollView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 必填 |
inertia | 惯性 | 数据 | boolean | 惯性开关 是否启用惯性滚动 | 开关 默认值：true | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置回弹时长
设置回弹时长：设置 ScrollView 的弹性回弹持续时间（秒）。 取值范围 0~10 秒，仅在弹性回弹开启时有效。 典型用途：按游戏风格调节回弹速度——休闲游戏偏慢，竞技游戏偏快。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | scrollViewSetBounceDuration |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | ScrollView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 必填 |
bounceDuration | 回弹时长 | 数据 | number | 回弹时长 弹性回弹持续时间（秒，0~10），仅在 elastic=true 时有效 | 输入框 默认值：1 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置内容节点
设置内容节点：设置 ScrollView 的可滚动内容节点。 传入 null 可清空引用。 注意：内容节点的父节点需要作为视口区域使用，否则滚动边界计算可能不符合预期。 典型用途：切换列表数据源时替换整个内容节点。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | scrollViewSetContent |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | ScrollView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 必填 |
content | 内容节点 | 数据 | cc.Node | 内容节点 ScrollView 的可滚动内容节点，传入 null 可清空 | - | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置取消子事件
设置取消子节点事件开关：设置 ScrollView 在滚动时是否取消子节点的触摸事件。 启用后可防止滚动干扰子节点的点击/拖拽。 注意：子节点的 touchstart 仍可能触发；短距离触摸下 touchmove/touchend 行为也存在例外。 典型用途：在列表中同时存在可点击按钮时开启，避免滚动误触。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | scrollViewSetCancelInnerEvents |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | ScrollView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 必填 |
cancelInnerEvents | 取消子事件 | 数据 | boolean | 取消子节点事件 滚动时是否取消子节点的触摸事件 | 开关 默认值：true | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置水平滚动
设置水平滚动开关：设置 ScrollView 是否启用水平滚动。 典型用途：在横向滚动关卡选择器中，根据关卡模式切换左右滑动权限。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | scrollViewSetHorizontal |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | ScrollView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 必填 |
horizontal | 水平滚动 | 数据 | boolean | 水平滚动 是否启用水平滚动 | 开关 默认值：true | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置水平滚动条
设置水平滚动条：设置 ScrollView 关联的水平滚动条组件。 传入 null 可清空绑定。 从 ScrollView 侧设置滚动条时，引擎会自动调用 ScrollBar.setScrollView(this)，这是推荐的绑定入口。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | scrollViewSetHorizontalScrollBar |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | ScrollView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 必填 |
horizontalScrollBar | 水平滚动条 | 数据 | cc.Component / ScrollBar | 水平滚动条 要关联的水平 ScrollBar 组件，传入 null 可清空 | - | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置所有属性
一次性批量修改 ScrollView 的多个常用属性。 公开引脚语义（重要）：除 exe 与 scrollView 外，所有可写属性引脚默认不公开（isPublic: false），只有被显式公开的引脚才参与写入。若想保留目标属性原值不变，必须保持引脚不公开——仅断开连线不够，已公开的引脚会用内联控件默认值覆盖原值。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | scrollViewSetProperties |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | ScrollView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 必填 |
content | 内容节点 | 数据 | cc.Node | 内容节点 ScrollView 的可滚动内容节点。默认不公开；公开后才参与写入。 | - | 可选 默认隐藏 |
horizontal | 水平滚动 | 数据 | boolean | 水平滚动 是否启用水平滚动。默认不公开；公开后才参与写入。 | 开关 默认值：true | 可选 默认隐藏 |
vertical | 垂直滚动 | 数据 | boolean | 垂直滚动 是否启用垂直滚动。默认不公开；公开后才参与写入。 | 开关 默认值：true | 可选 默认隐藏 |
inertia | 惯性 | 数据 | boolean | 惯性开关 是否启用惯性滚动。默认不公开；公开后才参与写入。 | 开关 默认值：true | 可选 默认隐藏 |
brake | 制动系数 | 数据 | number | 制动系数 惯性制动系数（0~1），1 为立刻停止。默认不公开；公开后才参与写入。 | 输入框 默认值：0.5 | 可选 默认隐藏 |
elastic | 弹性 | 数据 | boolean | 弹性开关 是否启用弹性回弹。默认不公开；公开后才参与写入。 | 开关 默认值：true | 可选 默认隐藏 |
bounceDuration | 回弹时长 | 数据 | number | 回弹时长 弹性回弹持续时间（秒，0~10）。默认不公开；公开后才参与写入。 | 输入框 默认值：1 | 可选 默认隐藏 |
horizontalScrollBar | 水平滚动条 | 数据 | cc.Component / ScrollBar | 水平滚动条 要关联的水平 ScrollBar 组件。默认不公开；公开后才参与写入。 | - | 可选 默认隐藏 |
verticalScrollBar | 垂直滚动条 | 数据 | cc.Component / ScrollBar | 垂直滚动条 要关联的垂直 ScrollBar 组件。默认不公开；公开后才参与写入。 | - | 可选 默认隐藏 |
cancelInnerEvents | 取消子事件 | 数据 | boolean | 取消子节点事件 滚动时是否取消子节点的触摸事件。默认不公开；公开后才参与写入。 | 开关 默认值：true | 可选 默认隐藏 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置制动系数
设置制动系数：设置 ScrollView 的惯性制动系数。 取值范围 0~1，值越大停止越快，1 表示立刻停止。仅在惯性开启时有效。 典型用途：在商店道具列表中调低制动系数，让玩家滑动浏览时手感更顺畅。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | scrollViewSetBrake |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | ScrollView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 必填 |
brake | 制动系数 | 数据 | number | 制动系数 惯性制动系数（0~1），1 为立刻停止 | 输入框 默认值：0.5 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
是否正在滚动
是否正在滚动：返回 ScrollView 当前是否正在滚动中（包括惯性滑动和自动滚动）。 典型用途：在滚动结束时播放音效或触发 UI 更新。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | scrollViewIsScrolling |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | ScrollView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
isScrolling | 滚动中 | 数据 | boolean | 滚动中 ScrollView 当前是否正在滚动 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
是否自动滚动
是否自动滚动：返回 ScrollView 当前是否正在自动滚动中（由 scrollTo 系列方法触发的动画滚动）。 区别于惯性滑动，自动滚动是程序控制的有目标位置的滚动。 典型用途：等待自动滚动完成后执行下一步操作（如滚动到指定项后高亮它）。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | scrollViewIsAutoScrolling |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | ScrollView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
isAutoScrolling | 自动滚动 | 数据 | boolean | 自动滚动中 ScrollView 当前是否正在自动滚动 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
停止自动滚动
停止自动滚动：立即停止 ScrollView 正在进行的自动滚动（包括 scrollTo 系列动画）。 典型用途：玩家在自动滚动过程中手动触摸时立即打断滚动，避免冲突。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | scrollViewStopAutoScroll |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | ScrollView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要操作的 ScrollView 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
ScrollView 事件
绑定 ScrollView 事件：在 ScrollView 发生指定类型的滚动事件时触发连接的 执行事件 节点。 支持的事件类型包括：
- scroll-to-top/bottom/left/right：滚动到边界时触发
- scroll-began：开始滚动时触发
- scroll-ended：滚动结束时触发
- bounce-top/bottom/left/right：对应方向的弹性回弹时触发
- scrolling：滚动过程中持续触发
- scroll-ended-with-threshold：滚动结束且超过阈值时触发
- touch-up：用户松手时触发
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | scrollViewEventBind |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | ScrollView |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | - | - | 可选 |
event | 事件 | 事件 | 事件 | 事件入口 连接到执行事件节点的事件输出引脚 | - | 必填 |
scrollView | 滚动视图 | 数据 | cc.Component / ScrollView | 目标滚动视图 要监听事件的 ScrollView 组件 | - | 必填 |
eventType | 事件类型 | 数据 | string | 事件类型 选择要监听的 ScrollView 事件类型 | 下拉选择 默认值：“scroll-ended” | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | - | - | 可选 |
handle | 句柄 | 数据 | eventHandle | 绑定句柄 用于后续取消这个具体监听。 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。