Cocos 组件 / UI / PageViewIndicator节点

学习目标

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

覆盖范围

• 节点数量：11
• 分类路径：Cocos 组件 / UI / PageViewIndicator

典型使用场景

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

通用注意事项

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

节点索引

节点	节点 ID	输入/输出	执行方式
绑定 PageView	pageViewIndicatorSetPageView	3 / 2	立即继续
获取摆放方向	pageViewIndicatorGetDirection	1 / 1	立即继续
获取标记尺寸	pageViewIndicatorGetCellSize	1 / 1	立即继续
获取标记间距	pageViewIndicatorGetSpacing	1 / 1	立即继续
获取标记图片	pageViewIndicatorGetSpriteFrame	1 / 1	立即继续
获取所有属性	pageViewIndicatorGetProperties	1 / 4	立即继续
设置摆放方向	pageViewIndicatorSetDirection	3 / 2	立即继续
设置标记尺寸	pageViewIndicatorSetCellSize	3 / 2	立即继续
设置标记间距	pageViewIndicatorSetSpacing	3 / 2	立即继续
设置标记图片	pageViewIndicatorSetSpriteFrame	3 / 2	立即继续
设置所有属性	pageViewIndicatorSetProperties	6 / 2	立即继续

绑定 PageView

绑定 PageView：将 PageViewIndicator 与目标 PageView 建立绑定。

节点信息

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

输入引脚

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

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
out	-	执行流	执行流	执行完成	-	可选
pageViewIndicator	指示器	数据	cc.Component / PageViewIndicator	目标指示器 要操作的 PageViewIndicator 组件	-	可选

使用场景

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

注意事项

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

---

获取摆放方向

获取指示器方向：返回翻页指示器小圆点的排列方向。

节点信息

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

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
pageViewIndicator	指示器	数据	cc.Component / PageViewIndicator	目标指示器 要操作的 PageViewIndicator 组件	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
direction	方向	数据	number	指示器方向 水平（=0）：标记横向排列 垂直（=1）：标记纵向排列	-	可选

使用场景

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

注意事项

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

---

获取标记尺寸

获取标记尺寸：返回 PageViewIndicator 每个标记的尺寸。

节点信息

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

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
pageViewIndicator	指示器	数据	cc.Component / PageViewIndicator	目标指示器 要操作的 PageViewIndicator 组件	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
cellSize	标记尺寸	数据	size	标记尺寸 每个标记的宽高	-	可选

使用场景

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

注意事项

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

---

获取标记间距

获取标记间距：返回 PageViewIndicator 标记之间的间距。

节点信息

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

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
pageViewIndicator	指示器	数据	cc.Component / PageViewIndicator	目标指示器 要操作的 PageViewIndicator 组件	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
spacing	间距	数据	number	标记间距 标记之间的间距值	-	可选

使用场景

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

注意事项

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

---

获取标记图片

获取标记图片：返回 PageViewIndicator 的标记精灵帧。

节点信息

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

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
pageViewIndicator	指示器	数据	cc.Component / PageViewIndicator	目标指示器 要操作的 PageViewIndicator 组件	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
spriteFrame	精灵帧	数据	cc.Asset / SpriteFrame	标记图片 指示器标记的精灵帧	-	可选

使用场景

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

注意事项

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

---

获取所有属性

一次性读出指示器的全部常用属性：标记图片、摆放方向、标记尺寸和标记间距。等同于连接多个 获取类节点，但只用一个节点即可。

节点信息

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

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
pageViewIndicator	指示器	数据	cc.Component / PageViewIndicator	目标指示器 要操作的 PageViewIndicator 组件	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
spriteFrame	精灵帧	数据	cc.Asset / SpriteFrame	标记图片 指示器标记的精灵帧	-	可选
direction	方向	数据	number	摆放方向 0=HORIZONTAL（水平） 1=VERTICAL（垂直）	-	可选
cellSize	标记尺寸	数据	size	标记尺寸 每个标记的宽高	-	可选
spacing	间距	数据	number	标记间距 标记之间的间距值	-	可选

使用场景

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

注意事项

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

---

设置摆放方向

设置指示器方向：更改翻页指示器小圆点的排列方向。 水平指示器适合常规横向翻页，垂直指示器适合纵向翻页。

节点信息

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

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	执行入口	-	可选
pageViewIndicator	指示器	数据	cc.Component / PageViewIndicator	目标指示器 要操作的 PageViewIndicator 组件	-	必填
direction	方向	数据	number	指示器方向 水平（=0）：标记横向排列 垂直（=1）：标记纵向排列	下拉选择 默认值：0	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
out	-	执行流	执行流	执行完成	-	可选
pageViewIndicator	指示器	数据	cc.Component / PageViewIndicator	目标指示器 要操作的 PageViewIndicator 组件	-	可选

使用场景

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

注意事项

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

---

设置标记尺寸

设置标记尺寸：设置 PageViewIndicator 每个标记的尺寸。

节点信息

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

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	执行入口	-	可选
pageViewIndicator	指示器	数据	cc.Component / PageViewIndicator	目标指示器 要操作的 PageViewIndicator 组件	-	必填
cellSize	标记尺寸	数据	size	标记尺寸 每个标记的宽高 [width, height]	-	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
out	-	执行流	执行流	执行完成	-	可选
pageViewIndicator	指示器	数据	cc.Component / PageViewIndicator	目标指示器 要操作的 PageViewIndicator 组件	-	可选

使用场景

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

注意事项

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

---

设置标记间距

设置标记间距：设置 PageViewIndicator 标记之间的间距。

节点信息

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

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	执行入口	-	可选
pageViewIndicator	指示器	数据	cc.Component / PageViewIndicator	目标指示器 要操作的 PageViewIndicator 组件	-	必填
spacing	间距	数据	number	标记间距 标记之间的间距值	输入框 默认值：0	必填

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
out	-	执行流	执行流	执行完成	-	可选
pageViewIndicator	指示器	数据	cc.Component / PageViewIndicator	目标指示器 要操作的 PageViewIndicator 组件	-	可选

使用场景

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

注意事项

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

---

设置标记图片

设置标记图片：设置 PageViewIndicator 的标记精灵帧。

节点信息

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

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	执行入口	-	可选
pageViewIndicator	指示器	数据	cc.Component / PageViewIndicator	目标指示器 要操作的 PageViewIndicator 组件	-	必填
spriteFrame	精灵帧	数据	cc.Asset / SpriteFrame	标记图片 要设置的精灵帧	-	可选

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
out	-	执行流	执行流	执行完成	-	可选
pageViewIndicator	指示器	数据	cc.Component / PageViewIndicator	目标指示器 要操作的 PageViewIndicator 组件	-	可选

使用场景

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

注意事项

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

---

设置所有属性

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

节点信息

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

输入引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
exe	-	执行流	执行流	执行入口	-	可选
pageViewIndicator	指示器	数据	cc.Component / PageViewIndicator	目标指示器 要操作的 PageViewIndicator 组件	-	必填
spriteFrame	精灵帧	数据	cc.Asset / SpriteFrame	标记图片 要设置的精灵帧。默认不公开；公开后才参与写入。	-	可选 默认隐藏
direction	方向	数据	number	摆放方向 HORIZONTAL 水平 / VERTICAL 垂直。默认不公开；公开后才参与写入。	下拉选择 默认值：0	可选 默认隐藏
cellSize	标记尺寸	数据	size	标记尺寸 每个标记的宽高。默认不公开；公开后才参与写入。	-	可选 默认隐藏
spacing	间距	数据	number	标记间距 标记之间的间距值。默认不公开；公开后才参与写入。	输入框 默认值：0	可选 默认隐藏

输出引脚

引脚 ID	名称	连接方式	值类型	用途	默认或选择	连接要求
out	-	执行流	执行流	执行完成	-	可选
pageViewIndicator	指示器	数据	cc.Component / PageViewIndicator	目标指示器 要操作的 PageViewIndicator 组件	-	可选

使用场景

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

注意事项

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