Cocos 组件 / UI / PageView节点

学习目标

访问 Cocos Creator 组件的属性、方法和事件，把引擎能力转成可视化工作流。

覆盖范围

• 节点数量：24
• 分类路径：Cocos 组件 / UI / PageView

典型使用场景

• 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
• 读取组件状态后驱动游戏逻辑
• 批量设置组件属性完成游戏运行时效果

通用注意事项

• 目标组件引脚必须连接正确的组件实例。
• 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
• 部分组件能力受 Cocos Creator 版本限制，页面会标出版本字段。

节点索引

节点	节点 ID	输入/输出	执行方式
按索引移除页面	pageViewRemovePageAtIndex	3 / 2	立即继续
插入页面	pageViewInsertPage	4 / 2	立即继续
翻页事件	pageViewPageTurningBind	3 / 2	立即继续
滚动到页面	pageViewScrollToPage	4 / 2	立即继续
获取尺寸模式	pageViewGetSizeMode	1 / 1	立即继续
获取当前页索引	pageViewGetCurrentPageIndex	1 / 1	立即继续
获取翻页速度	pageViewGetPageTurningSpeed	1 / 1	立即继续
获取滚动方向	pageViewGetDirection	1 / 1	立即继续
获取滚动临界值	pageViewGetScrollThreshold	1 / 1	立即继续
获取快速翻页临界值	pageViewGetAutoPageTurningThreshold	1 / 1	立即继续
获取所有属性	pageViewGetProperties	1 / 6	立即继续
获取页面列表	pageViewGetPages	1 / 1	立即继续
获取指示器	pageViewGetIndicator	1 / 1	立即继续
设置尺寸模式	pageViewSetSizeMode	3 / 2	立即继续
设置当前页索引	pageViewSetCurrentPageIndex	3 / 2	立即继续
设置翻页速度	pageViewSetPageTurningSpeed	3 / 2	立即继续
设置滚动方向	pageViewSetDirection	3 / 2	立即继续
设置滚动临界值	pageViewSetScrollThreshold	3 / 2	立即继续
设置快速翻页临界值	pageViewSetAutoPageTurningThreshold	3 / 2	立即继续
设置所有属性	pageViewSetProperties	8 / 2	立即继续
设置指示器	pageViewSetIndicator	3 / 2	立即继续
添加页面	pageViewAddPage	3 / 2	立即继续
移除所有页面	pageViewRemoveAllPages	2 / 2	立即继续
移除页面	pageViewRemovePage	3 / 2	立即继续

按索引移除页面

按索引移除页面：移除指定索引处的页面。 典型用途：移除第 2 页的过期推广内容。

节点信息

字段	值
节点 ID	pageViewRemovePageAtIndex
分类	Cocos 组件
二级分类	UI
分组	PageView
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	执行入口	-	可选
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	必填
index	索引	数据	number	页面索引 要移除的页面索引	输入框 默认值：0	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
out	-	执行流	执行流	执行完成	-	可选
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	可选

使用场景

• 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
• 读取组件状态后驱动游戏逻辑
• 批量设置组件属性完成游戏运行时效果

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 目标组件引脚必须连接正确的组件实例。
• 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。

---

插入页面

插入页面：在指定索引位置插入一个页面节点。 典型用途：在特定位置插入页面，如第 3 页后插入新活动页面。

节点信息

字段	值
节点 ID	pageViewInsertPage
分类	Cocos 组件
二级分类	UI
分组	PageView
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	执行入口	-	可选
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	必填
page	页面	数据	cc.Node	页面节点 要插入的页面节点	-	必填
index	索引	数据	number	插入索引 要插入的目标位置索引	输入框 默认值：0	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
out	-	执行流	执行流	执行完成	-	可选
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	可选

使用场景

• 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
• 读取组件状态后驱动游戏逻辑
• 批量设置组件属性完成游戏运行时效果

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 目标组件引脚必须连接正确的组件实例。
• 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。

---

翻页事件

绑定翻页事件：在 PageView 翻页时触发连接的 执行事件 节点。 每次翻页完成后触发。典型用途：翻页后更新页面指示器、同步 UI 状态。

节点信息

字段	值
节点 ID	pageViewPageTurningBind
分类	Cocos 组件
二级分类	UI
分组	PageView
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	-	-	可选
event	事件	事件	事件	事件入口 连接到执行事件节点的事件输出引脚	-	必填
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要监听翻页事件的 PageView 组件	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	-	-	可选
handle	句柄	数据	eventHandle	绑定句柄 用于后续取消这个具体监听。	-	可选

使用场景

• 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
• 读取组件状态后驱动游戏逻辑
• 批量设置组件属性完成游戏运行时效果

注意事项

• 适合的工作流类型：component。
• 目标组件引脚必须连接正确的组件实例。
• 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。

---

滚动到页面

滚动到页面：以动画方式平滑滚动到指定页面。 可通过 timeInSecond 控制动画时长。典型用途：新手引导时自动翻到下一页。

节点信息

字段	值
节点 ID	pageViewScrollToPage
分类	Cocos 组件
二级分类	UI
分组	PageView
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	执行入口	-	可选
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	必填
index	索引	数据	number	目标页索引 要滚动到的页面索引	输入框 默认值：0	必填
timeInSecond	动画时长	数据	number	动画时长 滚动动画的持续时间（秒），不传则使用默认速度	输入框 默认值：0.3	可选

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
out	-	执行流	执行流	执行完成	-	可选
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	可选

使用场景

• 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
• 读取组件状态后驱动游戏逻辑
• 批量设置组件属性完成游戏运行时效果

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 目标组件引脚必须连接正确的组件实例。
• 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。

---

获取尺寸模式

获取尺寸模式：返回 PageView 的页面尺寸模式。 统一尺寸：所有页面大小相同；自由尺寸：各页面可不同大小。

节点信息

字段	值
节点 ID	pageViewGetSizeMode
分类	Cocos 组件
二级分类	UI
分组	PageView
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
sizeMode	尺寸模式	数据	number	尺寸模式 统一尺寸（=0）：所有页面大小相同 自由尺寸（=1）：各页面可不同	-	可选

使用场景

• 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
• 读取组件状态后驱动游戏逻辑
• 批量设置组件属性完成游戏运行时效果

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 目标组件引脚必须连接正确的组件实例。
• 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。

---

获取当前页索引

获取当前页索引：返回 PageView 当前显示的页面索引（从 0 开始）。 典型用途：判断玩家当前在第几页，或根据页面切换 UI 状态。

节点信息

字段	值
节点 ID	pageViewGetCurrentPageIndex
分类	Cocos 组件
二级分类	UI
分组	PageView
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
index	索引	数据	number	当前页索引 当前显示的页面索引（从0开始）	-	可选

使用场景

• 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
• 读取组件状态后驱动游戏逻辑
• 批量设置组件属性完成游戏运行时效果

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 目标组件引脚必须连接正确的组件实例。
• 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。

---

获取翻页速度

获取翻页速度：返回 PageView 的翻页动画速度（秒）。

节点信息

字段	值
节点 ID	pageViewGetPageTurningSpeed
分类	Cocos 组件
二级分类	UI
分组	PageView
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
pageTurningSpeed	速度	数据	number	翻页速度 翻页动画的持续时间（秒）	-	可选

使用场景

• 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
• 读取组件状态后驱动游戏逻辑
• 批量设置组件属性完成游戏运行时效果

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 目标组件引脚必须连接正确的组件实例。
• 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。

---

获取滚动方向

获取滚动方向：返回 PageView 的滚动方向。 水平：左右滑动；垂直：上下滑动。

节点信息

字段	值
节点 ID	pageViewGetDirection
分类	Cocos 组件
二级分类	UI
分组	PageView
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
direction	方向	数据	number	滚动方向 水平（=0）：左右滑动 垂直（=1）：上下滑动	-	可选

使用场景

• 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
• 读取组件状态后驱动游戏逻辑
• 批量设置组件属性完成游戏运行时效果

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 目标组件引脚必须连接正确的组件实例。
• 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。

---

获取滚动临界值

获取滚动临界值：返回 PageView 的滚动临界值。 超过此值后触发翻页，取值 0~1。0.5 表示滑动到一半即翻页。

节点信息

字段	值
节点 ID	pageViewGetScrollThreshold
分类	Cocos 组件
二级分类	UI
分组	PageView
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
scrollThreshold	临界值	数据	number	滚动临界值 超过此值后触发翻页（0~1）	-	可选

使用场景

• 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
• 读取组件状态后驱动游戏逻辑
• 批量设置组件属性完成游戏运行时效果

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 目标组件引脚必须连接正确的组件实例。
• 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。

---

获取快速翻页临界值

获取快速翻页临界值：返回快速滑动自动翻页的速度临界值。

节点信息

字段	值
节点 ID	pageViewGetAutoPageTurningThreshold
分类	Cocos 组件
二级分类	UI
分组	PageView
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
autoPageTurningThreshold	临界值	数据	number	快速翻页临界值 快速滑动自动翻页的速度临界值	-	可选

使用场景

• 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
• 读取组件状态后驱动游戏逻辑
• 批量设置组件属性完成游戏运行时效果

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 目标组件引脚必须连接正确的组件实例。
• 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。

---

获取所有属性

一次性读出 PageView 的全部常用属性：尺寸模式、方向、临界值、翻页速度、指示器。等同于连接多个 获取类节点，但只用一个节点即可。适合序列化、调试、批量比较等场景。

节点信息

字段	值
节点 ID	pageViewGetProperties
分类	Cocos 组件
二级分类	UI
分组	PageView
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
sizeMode	尺寸模式	数据	number	尺寸模式 0=Unified（统一尺寸） 1=Free（自由尺寸）	-	可选
direction	方向	数据	number	滚动方向 0=Horizontal（水平） 1=Vertical（垂直）	-	可选
scrollThreshold	临界值	数据	number	滚动临界值 超过此值后触发翻页（0~1）	-	可选
autoPageTurningThreshold	快速翻页临界值	数据	number	快速翻页临界值 快速滑动自动翻页的速度临界值	-	可选
pageTurningSpeed	翻页速度	数据	number	翻页速度 翻页动画的持续时间（秒）	-	可选
indicator	指示器	数据	cc.Component / PageViewIndicator	页面指示器 关联的 PageViewIndicator 组件	-	可选

使用场景

• 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
• 读取组件状态后驱动游戏逻辑
• 批量设置组件属性完成游戏运行时效果

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 目标组件引脚必须连接正确的组件实例。
• 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。

---

获取页面列表

获取页面列表：返回 PageView 中所有页面节点的数组。 典型用途：遍历所有页面进行批量操作，如逐页设置内容。

节点信息

字段	值
节点 ID	pageViewGetPages
分类	Cocos 组件
二级分类	UI
分组	PageView
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
pages	页面列表	数据	cc.Node / array	页面列表 所有页面节点的数组	-	可选

使用场景

• 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
• 读取组件状态后驱动游戏逻辑
• 批量设置组件属性完成游戏运行时效果

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 目标组件引脚必须连接正确的组件实例。
• 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。

---

获取指示器

获取指示器：返回 PageView 关联的页面指示器组件。 典型用途：获取指示器以进一步自定义其样式或隐藏/显示。

节点信息

字段	值
节点 ID	pageViewGetIndicator
分类	Cocos 组件
二级分类	UI
分组	PageView
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
indicator	指示器	数据	cc.Component / PageViewIndicator	页面指示器 关联的 PageViewIndicator 组件	-	可选

使用场景

• 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
• 读取组件状态后驱动游戏逻辑
• 批量设置组件属性完成游戏运行时效果

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 目标组件引脚必须连接正确的组件实例。
• 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。

---

设置尺寸模式

设置尺寸模式：设置 PageView 的页面尺寸模式。 统一尺寸：所有页面大小相同，适合标准图集展示；自由尺寸：各页面可不同，适合混合内容。

节点信息

字段	值
节点 ID	pageViewSetSizeMode
分类	Cocos 组件
二级分类	UI
分组	PageView
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	执行入口	-	可选
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	必填
sizeMode	尺寸模式	数据	number	尺寸模式 统一尺寸（=0）：所有页面大小相同 自由尺寸（=1）：各页面可不同	下拉选择 默认值：0	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
out	-	执行流	执行流	执行完成	-	可选
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	可选

使用场景

• 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
• 读取组件状态后驱动游戏逻辑
• 批量设置组件属性完成游戏运行时效果

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 目标组件引脚必须连接正确的组件实例。
• 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。

---

设置当前页索引

设置当前页索引：设置 PageView 当前显示的页面索引（从 0 开始）。 典型用途：直接跳转到指定页面，如从第 1 页跳到第 5 页。

节点信息

字段	值
节点 ID	pageViewSetCurrentPageIndex
分类	Cocos 组件
二级分类	UI
分组	PageView
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	执行入口	-	可选
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	必填
index	索引	数据	number	页面索引 要显示的页面索引（从0开始）	输入框 默认值：0	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
out	-	执行流	执行流	执行完成	-	可选
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	可选

使用场景

• 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
• 读取组件状态后驱动游戏逻辑
• 批量设置组件属性完成游戏运行时效果

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 目标组件引脚必须连接正确的组件实例。
• 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。

---

设置翻页速度

设置翻页速度：设置 PageView 的翻页动画速度（秒）。

节点信息

字段	值
节点 ID	pageViewSetPageTurningSpeed
分类	Cocos 组件
二级分类	UI
分组	PageView
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	执行入口	-	可选
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	必填
pageTurningSpeed	速度	数据	number	翻页速度 翻页动画的持续时间（秒）	输入框 默认值：0.3	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
out	-	执行流	执行流	执行完成	-	可选
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	可选

使用场景

• 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
• 读取组件状态后驱动游戏逻辑
• 批量设置组件属性完成游戏运行时效果

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 目标组件引脚必须连接正确的组件实例。
• 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。

---

设置滚动方向

设置滚动方向：设置 PageView 的滚动方向。 水平：左右翻页，适合图集；垂直：上下翻页，适合长列表分页。

节点信息

字段	值
节点 ID	pageViewSetDirection
分类	Cocos 组件
二级分类	UI
分组	PageView
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	执行入口	-	可选
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	必填
direction	方向	数据	number	滚动方向 水平（=0）：左右滑动 垂直（=1）：上下滑动	下拉选择 默认值：0	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
out	-	执行流	执行流	执行完成	-	可选
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	可选

使用场景

• 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
• 读取组件状态后驱动游戏逻辑
• 批量设置组件属性完成游戏运行时效果

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 目标组件引脚必须连接正确的组件实例。
• 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。

---

设置滚动临界值

设置滚动临界值：设置 PageView 的滚动临界值。 取值 0~1。值越小越容易翻页（如 0.2 滑动少量即翻页），值越大翻页越困难（如 0.8 需滑动更多）。

节点信息

字段	值
节点 ID	pageViewSetScrollThreshold
分类	Cocos 组件
二级分类	UI
分组	PageView
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	执行入口	-	可选
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	必填
scrollThreshold	临界值	数据	number	滚动临界值 超过此值后触发翻页（0~1）	输入框 默认值：0.5	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
out	-	执行流	执行流	执行完成	-	可选
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	可选

使用场景

• 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
• 读取组件状态后驱动游戏逻辑
• 批量设置组件属性完成游戏运行时效果

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 目标组件引脚必须连接正确的组件实例。
• 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。

---

设置快速翻页临界值

设置快速翻页临界值：设置快速滑动自动翻页的速度临界值。

节点信息

字段	值
节点 ID	pageViewSetAutoPageTurningThreshold
分类	Cocos 组件
二级分类	UI
分组	PageView
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	执行入口	-	可选
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	必填
autoPageTurningThreshold	临界值	数据	number	快速翻页临界值 快速滑动自动翻页的速度临界值	输入框 默认值：0.5	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
out	-	执行流	执行流	执行完成	-	可选
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	可选

使用场景

• 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
• 读取组件状态后驱动游戏逻辑
• 批量设置组件属性完成游戏运行时效果

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 目标组件引脚必须连接正确的组件实例。
• 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。

---

设置所有属性

一次性批量修改 PageView 的多个常用属性。 公开引脚语义（重要）：除 exe 与 pageView 外，所有可写属性引脚默认不公开（isPublic: false），只有被显式公开的引脚才参与写入。若想保留目标属性原值不变，必须保持引脚不公开——仅断开连线不够，已公开的引脚会用内联控件默认值覆盖原值。

节点信息

字段	值
节点 ID	pageViewSetProperties
分类	Cocos 组件
二级分类	UI
分组	PageView
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	执行入口	-	可选
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	必填
sizeMode	尺寸模式	数据	number	尺寸模式 0=Unified（统一尺寸）, 1=Free（自由尺寸）。默认不公开；公开后才参与写入。	下拉选择 默认值：0	可选 默认隐藏
direction	方向	数据	number	滚动方向 0=Horizontal（水平）, 1=Vertical（垂直）。默认不公开；公开后才参与写入。	下拉选择 默认值：0	可选 默认隐藏
scrollThreshold	临界值	数据	number	滚动临界值 超过此值后触发翻页（0~1）。默认不公开；公开后才参与写入。	输入框 默认值：0.5	可选 默认隐藏
autoPageTurningThreshold	快速翻页临界值	数据	number	快速翻页临界值 快速滑动自动翻页的速度临界值。默认不公开；公开后才参与写入。	输入框 默认值：0.5	可选 默认隐藏
pageTurningSpeed	翻页速度	数据	number	翻页速度 翻页动画的持续时间（秒）。默认不公开；公开后才参与写入。	输入框 默认值：0.3	可选 默认隐藏
indicator	指示器	数据	cc.Component / PageViewIndicator	页面指示器 要关联的 PageViewIndicator 组件。默认不公开；公开后才参与写入。	-	可选 默认隐藏

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
out	-	执行流	执行流	执行完成	-	可选
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	可选

使用场景

• 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
• 读取组件状态后驱动游戏逻辑
• 批量设置组件属性完成游戏运行时效果

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 目标组件引脚必须连接正确的组件实例。
• 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。

---

设置指示器

设置指示器：设置 PageView 关联的页面指示器组件。 典型用途：更换指示器的外观样式，如切换大小圆点或方块指示器。

节点信息

字段	值
节点 ID	pageViewSetIndicator
分类	Cocos 组件
二级分类	UI
分组	PageView
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	执行入口	-	可选
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	必填
indicator	指示器	数据	cc.Component / PageViewIndicator	页面指示器 要关联的 PageViewIndicator 组件	-	可选

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
out	-	执行流	执行流	执行完成	-	可选
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	可选

使用场景

• 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
• 读取组件状态后驱动游戏逻辑
• 批量设置组件属性完成游戏运行时效果

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 目标组件引脚必须连接正确的组件实例。
• 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。

---

添加页面

添加页面：在 PageView 末尾添加一个页面节点。 典型用途：动态增加新页面以展示更多内容。

节点信息

字段	值
节点 ID	pageViewAddPage
分类	Cocos 组件
二级分类	UI
分组	PageView
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	执行入口	-	可选
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	必填
page	页面	数据	cc.Node	页面节点 要添加的页面节点	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
out	-	执行流	执行流	执行完成	-	可选
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	可选

使用场景

• 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
• 读取组件状态后驱动游戏逻辑
• 批量设置组件属性完成游戏运行时效果

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 目标组件引脚必须连接正确的组件实例。
• 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。

---

移除所有页面

移除所有页面：清空 PageView 中的所有页面。 典型用途：清空后重新加载全新的页面列表。

节点信息

字段	值
节点 ID	pageViewRemoveAllPages
分类	Cocos 组件
二级分类	UI
分组	PageView
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	执行入口	-	可选
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
out	-	执行流	执行流	执行完成	-	可选
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	可选

使用场景

• 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
• 读取组件状态后驱动游戏逻辑
• 批量设置组件属性完成游戏运行时效果

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 目标组件引脚必须连接正确的组件实例。
• 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。

---

移除页面

移除页面：移除指定的页面节点。 典型用途：移除不再展示的页面，如下架的活动页面。

节点信息

字段	值
节点 ID	pageViewRemovePage
分类	Cocos 组件
二级分类	UI
分组	PageView
是否需要等待结果	否
是否需要先选择目标	否

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	执行入口	-	可选
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	必填
page	页面	数据	cc.Node	页面节点 要移除的页面节点	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
out	-	执行流	执行流	执行完成	-	可选
pageView	分页视图	数据	cc.Component / PageView	目标分页视图 要操作的 PageView 组件	-	可选

使用场景

• 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
• 读取组件状态后驱动游戏逻辑
• 批量设置组件属性完成游戏运行时效果

注意事项

• 适合的工作流类型：component、library、method、function、class。
• 目标组件引脚必须连接正确的组件实例。
• 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。