使用指南
Cocos 组件 / UI / Widget节点
Cocos 组件 / UI / Widget 节点手册，包含 45 个节点的用途、引脚、使用场景和注意事项。
16
学习目标
访问 Cocos Creator 组件的属性、方法和事件，把引擎能力转成可视化工作流。
覆盖范围
- 节点数量：45
- 分类路径：Cocos 组件 / UI / Widget
典型使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
通用注意事项
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
- 部分组件能力受 Cocos Creator 版本限制，页面会标出版本字段。
节点索引
| 节点 | 节点 ID | 输入/输出 | 执行方式 |
|---|---|---|---|
| 获取垂直居中对齐 | widgetGetIsAlignVerticalCenter | 1 / 1 | 立即继续 |
| 获取垂直居中偏移 | widgetGetVerticalCenter | 1 / 1 | 立即继续 |
| 获取垂直居中像素模式 | widgetGetIsAbsoluteVerticalCenter | 1 / 1 | 立即继续 |
| 获取垂直拉伸 | widgetGetIsStretchHeight | 1 / 1 | 立即继续 |
| 获取底部边距 | widgetGetBottom | 1 / 1 | 立即继续 |
| 获取底部对齐 | widgetGetIsAlignBottom | 1 / 1 | 立即继续 |
| 获取底部像素模式 | widgetGetIsAbsoluteBottom | 1 / 1 | 立即继续 |
| 获取顶部边距 | widgetGetTop | 1 / 1 | 立即继续 |
| 获取顶部对齐 | widgetGetIsAlignTop | 1 / 1 | 立即继续 |
| 获取顶部像素模式 | widgetGetIsAbsoluteTop | 1 / 1 | 立即继续 |
| 获取对齐模式 | widgetGetAlignMode | 1 / 1 | 立即继续 |
| 获取对齐目标 | widgetGetTarget | 1 / 1 | 立即继续 |
| 获取水平居中对齐 | widgetGetIsAlignHorizontalCenter | 1 / 1 | 立即继续 |
| 获取水平居中偏移 | widgetGetHorizontalCenter | 1 / 1 | 立即继续 |
| 获取水平居中像素模式 | widgetGetIsAbsoluteHorizontalCenter | 1 / 1 | 立即继续 |
| 获取水平拉伸 | widgetGetIsStretchWidth | 1 / 1 | 立即继续 |
| 获取所有属性 | widgetGetProperties | 1 / 22 | 立即继续 |
| 获取右侧边距 | widgetGetRight | 1 / 1 | 立即继续 |
| 获取右侧对齐 | widgetGetIsAlignRight | 1 / 1 | 立即继续 |
| 获取右侧像素模式 | widgetGetIsAbsoluteRight | 1 / 1 | 立即继续 |
| 获取左侧边距 | widgetGetLeft | 1 / 1 | 立即继续 |
| 获取左侧对齐 | widgetGetIsAlignLeft | 1 / 1 | 立即继续 |
| 获取左侧像素模式 | widgetGetIsAbsoluteLeft | 1 / 1 | 立即继续 |
| 立即刷新对齐 | widgetUpdateAlignment | 2 / 2 | 立即继续 |
| 设置垂直居中对齐 | widgetSetIsAlignVerticalCenter | 3 / 2 | 立即继续 |
| 设置垂直居中偏移 | widgetSetVerticalCenter | 3 / 2 | 立即继续 |
| 设置垂直居中像素模式 | widgetSetIsAbsoluteVerticalCenter | 3 / 2 | 立即继续 |
| 设置底部边距 | widgetSetBottom | 3 / 2 | 立即继续 |
| 设置底部对齐 | widgetSetIsAlignBottom | 3 / 2 | 立即继续 |
| 设置底部像素模式 | widgetSetIsAbsoluteBottom | 3 / 2 | 立即继续 |
| 设置顶部边距 | widgetSetTop | 3 / 2 | 立即继续 |
| 设置顶部对齐 | widgetSetIsAlignTop | 3 / 2 | 立即继续 |
| 设置顶部像素模式 | widgetSetIsAbsoluteTop | 3 / 2 | 立即继续 |
| 设置对齐模式 | widgetSetAlignMode | 3 / 2 | 立即继续 |
| 设置对齐目标 | widgetSetTarget | 3 / 2 | 立即继续 |
| 设置水平居中对齐 | widgetSetIsAlignHorizontalCenter | 3 / 2 | 立即继续 |
| 设置水平居中偏移 | widgetSetHorizontalCenter | 3 / 2 | 立即继续 |
| 设置水平居中像素模式 | widgetSetIsAbsoluteHorizontalCenter | 3 / 2 | 立即继续 |
| 设置所有属性 | widgetSetProperties | 22 / 2 | 立即继续 |
| 设置右侧边距 | widgetSetRight | 3 / 2 | 立即继续 |
| 设置右侧对齐 | widgetSetIsAlignRight | 3 / 2 | 立即继续 |
| 设置右侧像素模式 | widgetSetIsAbsoluteRight | 3 / 2 | 立即继续 |
| 设置左侧边距 | widgetSetLeft | 3 / 2 | 立即继续 |
| 设置左侧对齐 | widgetSetIsAlignLeft | 3 / 2 | 立即继续 |
| 设置左侧像素模式 | widgetSetIsAbsoluteLeft | 3 / 2 | 立即继续 |
获取垂直居中对齐
获取垂直居中对齐开关：返回 Widget 是否启用垂直居中对齐。 启用后会取消顶部和底部对齐。垂直居中偏移值只有在此开关开启时才生效。 典型用途：实现 UI 面板在父容器中垂直居中。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetGetIsAlignVerticalCenter |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
isAlignVerticalCenter | 垂直居中对齐 | 数据 | boolean | 垂直居中对齐 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取垂直居中偏移
获取垂直居中偏移：返回 Widget 的垂直居中偏移值。 仅在垂直居中对齐开启时生效。允许负值（向上偏移）。true=像素值，false=相对父节点高度的百分比偏移。 典型用途：微调 UI 面板的垂直居中位置。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetGetVerticalCenter |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
verticalCenter | 垂直居中偏移 | 数据 | number | 垂直居中偏移 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取垂直居中像素模式
获取垂直居中像素模式：返回垂直居中偏移值是否以像素为单位。 true=像素值；false=相对父节点高度的百分比。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetGetIsAbsoluteVerticalCenter |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
isAbsoluteVerticalCenter | 垂直居中像素模式 | 数据 | boolean | 垂直居中像素模式 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取垂直拉伸
获取垂直拉伸状态：返回 Widget 当前是否处于垂直拉伸模式。 这是一个只读推导状态：当顶部和底部同时启用对齐时，Widget 会自动进入垂直拉伸，此时节点高度由 Widget 自动控制。此属性不可直接设置，需要通过调整上下对齐开关间接控制。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetGetIsStretchHeight |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
isStretchHeight | 垂直拉伸 | 数据 | boolean | 垂直拉伸 上下同时对齐时为 true，表示高度由 Widget 自动控制 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取底部边距
获取底部边距：返回 Widget 的底部边距值。 仅在底部对齐开启时生效。允许负值（向下偏移）。true=像素值，false=相对父节点高度的百分比。 典型用途：让 UI 面板底边距离屏幕底部固定 10 像素。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetGetBottom |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
bottom | 底部边距 | 数据 | number | 底部边距 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取底部对齐
获取底部对齐开关：返回 Widget 是否启用底部对齐。 启用后节点底部边距参与对齐计算。同时启用顶部和底部对齐 = 垂直拉伸。启用垂直居中时会取消顶部和底部对齐。 典型用途：让 UI 面板底边始终吸附在屏幕底部。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetGetIsAlignBottom |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
isAlignBottom | 底部对齐 | 数据 | boolean | 底部对齐 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取底部像素模式
获取底部像素模式：返回底部边距是否以像素为单位。 true=像素值；false=相对父节点高度的百分比。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetGetIsAbsoluteBottom |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
isAbsoluteBottom | 底部像素模式 | 数据 | boolean | 底部像素模式 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取顶部边距
获取顶部边距：返回 Widget 的顶部边距值。 仅在顶部对齐开启时生效。允许负值（向上偏移）。true=像素值，false=相对父节点高度的百分比。 典型用途：让 UI 面板顶边距离屏幕顶部固定 10 像素。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetGetTop |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
top | 顶部边距 | 数据 | number | 顶部边距 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取顶部对齐
获取顶部对齐开关：返回 Widget 是否启用顶部对齐。 启用后节点顶部边距参与对齐计算。同时启用顶部和底部对齐 = 垂直拉伸（自动填满父节点高度）。启用垂直居中时会自动关闭顶部和底部对齐。 典型用途：让 UI 面板顶边始终吸附在屏幕顶部。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetGetIsAlignTop |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
isAlignTop | 顶部对齐 | 数据 | boolean | 顶部对齐 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取顶部像素模式
获取顶部像素模式：返回顶部边距是否以像素为单位。 true=像素值（固定大小）；false=相对父节点高度的百分比。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetGetIsAbsoluteTop |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
isAbsoluteTop | 顶部像素模式 | 数据 | boolean | 顶部像素模式 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取对齐模式
获取对齐模式：返回 Widget 的对齐刷新模式。 0=ONCE（首次启用时对齐一次，之后不再自动对齐） 1=ALWAYS（每帧始终保持对齐） 2=ON_WINDOW_RESIZE（窗口尺寸变化时重新对齐，其余时间不自动对齐）
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetGetAlignMode |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
alignMode | 对齐模式 | 数据 | number | 对齐模式 0=ONCE（首次对齐一次） 1=ALWAYS（始终保持对齐） 2=ON_WINDOW_RESIZE（窗口变化时重新对齐） | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取对齐目标
获取对齐目标：返回 Widget 的对齐目标节点。 target 只能是当前节点的某个父节点。返回 null 表示使用当前父节点作为对齐参考。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetGetTarget |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
target | 目标节点 | 数据 | cc.Node | 对齐目标节点 只能是当前节点的某个父节点，null 表示使用当前父节点 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取水平居中对齐
获取水平居中对齐开关：返回 Widget 是否启用水平居中对齐。 启用后会取消左侧和右侧对齐。水平居中偏移值只有在此开关开启时才生效。 典型用途：实现 UI 面板在父容器中水平居中。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetGetIsAlignHorizontalCenter |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
isAlignHorizontalCenter | 水平居中对齐 | 数据 | boolean | 水平居中对齐 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取水平居中偏移
获取水平居中偏移：返回 Widget 的水平居中偏移值。 仅在水平居中对齐开启时生效。允许负值（向左偏移）。true=像素值，false=相对父节点宽度的百分比偏移。 典型用途：微调 UI 面板的水平居中位置。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetGetHorizontalCenter |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
horizontalCenter | 水平居中偏移 | 数据 | number | 水平居中偏移 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取水平居中像素模式
获取水平居中像素模式：返回水平居中偏移值是否以像素为单位。 true=像素值；false=相对父节点宽度的百分比。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetGetIsAbsoluteHorizontalCenter |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
isAbsoluteHorizontalCenter | 水平居中像素模式 | 数据 | boolean | 水平居中像素模式 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取水平拉伸
获取水平拉伸状态：返回 Widget 当前是否处于水平拉伸模式。 这是一个只读推导状态：当左侧和右侧同时启用对齐时，Widget 会自动进入水平拉伸，此时节点宽度由 Widget 自动控制。此属性不可直接设置，需要通过调整左右对齐开关间接控制。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetGetIsStretchWidth |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
isStretchWidth | 水平拉伸 | 数据 | boolean | 水平拉伸 左右同时对齐时为 true，表示宽度由 Widget 自动控制 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取所有属性
一次性读出 Widget 组件的全部常用属性：对齐目标、对齐模式、各方向对齐开关、边距/偏移、像素/比例模式及拉伸状态。等同于连接多个 获取类节点，但只用一个节点即可。适合序列化、调试、批量比较等场景。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetGetProperties |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
target | 目标节点 | 数据 | cc.Node | 对齐目标节点 Widget 的对齐目标，null 表示使用当前父节点。 | - | 可选 |
alignMode | 对齐模式 | 数据 | number | 对齐模式 0=ONCE 1=ALWAYS 2=ON_WINDOW_RESIZE | - | 可选 |
isAlignTop | 顶部对齐 | 数据 | boolean | 顶部对齐 | - | 可选 |
isAlignBottom | 底部对齐 | 数据 | boolean | 底部对齐 | - | 可选 |
isAlignLeft | 左侧对齐 | 数据 | boolean | 左侧对齐 | - | 可选 |
isAlignRight | 右侧对齐 | 数据 | boolean | 右侧对齐 | - | 可选 |
isAlignVerticalCenter | 垂直居中对齐 | 数据 | boolean | 垂直居中对齐 | - | 可选 |
isAlignHorizontalCenter | 水平居中对齐 | 数据 | boolean | 水平居中对齐 | - | 可选 |
isStretchWidth | 水平拉伸 | 数据 | boolean | 水平拉伸 只读派生状态，左右同时对齐时为 true。 | - | 可选 |
isStretchHeight | 垂直拉伸 | 数据 | boolean | 垂直拉伸 只读派生状态，上下同时对齐时为 true。 | - | 可选 |
top | 顶部边距 | 数据 | number | 顶部边距 | - | 可选 |
bottom | 底部边距 | 数据 | number | 底部边距 | - | 可选 |
left | 左侧边距 | 数据 | number | 左侧边距 | - | 可选 |
right | 右侧边距 | 数据 | number | 右侧边距 | - | 可选 |
horizontalCenter | 水平居中偏移 | 数据 | number | 水平居中偏移 | - | 可选 |
verticalCenter | 垂直居中偏移 | 数据 | number | 垂直居中偏移 | - | 可选 |
isAbsoluteTop | 顶部像素模式 | 数据 | boolean | 顶部像素模式 | - | 可选 |
isAbsoluteBottom | 底部像素模式 | 数据 | boolean | 底部像素模式 | - | 可选 |
isAbsoluteLeft | 左侧像素模式 | 数据 | boolean | 左侧像素模式 | - | 可选 |
isAbsoluteRight | 右侧像素模式 | 数据 | boolean | 右侧像素模式 | - | 可选 |
isAbsoluteHorizontalCenter | 水平居中像素模式 | 数据 | boolean | 水平居中像素模式 | - | 可选 |
isAbsoluteVerticalCenter | 垂直居中像素模式 | 数据 | boolean | 垂直居中像素模式 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取右侧边距
获取右侧边距：返回 Widget 的右侧边距值。 仅在右侧对齐开启时生效。允许负值（向右偏移）。true=像素值，false=相对父节点宽度的百分比。 典型用途：让 UI 面板右边距离屏幕右边缘固定 10 像素。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetGetRight |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
right | 右侧边距 | 数据 | number | 右侧边距 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取右侧对齐
获取右侧对齐开关：返回 Widget 是否启用右侧对齐。 启用后节点右侧边距参与对齐计算。同时启用左侧和右侧对齐 = 水平拉伸。启用水平居中时会取消左侧和右侧对齐。 典型用途：让 UI 面板右边始终吸附在屏幕右侧。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetGetIsAlignRight |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
isAlignRight | 右侧对齐 | 数据 | boolean | 右侧对齐 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取右侧像素模式
获取右侧像素模式：返回右侧边距是否以像素为单位。 true=像素值；false=相对父节点宽度的百分比。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetGetIsAbsoluteRight |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
isAbsoluteRight | 右侧像素模式 | 数据 | boolean | 右侧像素模式 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取左侧边距
获取左侧边距：返回 Widget 的左侧边距值。 仅在左侧对齐开启时生效。允许负值（向左偏移）。true=像素值，false=相对父节点宽度的百分比。 典型用途：让 UI 面板左边距离屏幕左边缘固定 10 像素。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetGetLeft |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
left | 左侧边距 | 数据 | number | 左侧边距 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取左侧对齐
获取左侧对齐开关：返回 Widget 是否启用左侧对齐。 启用后节点左侧边距参与对齐计算。同时启用左侧和右侧对齐 = 水平拉伸（自动填满父节点宽度）。启用水平居中时会自动关闭左侧和右侧对齐。 典型用途：让 UI 面板左边始终吸附在屏幕左侧。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetGetIsAlignLeft |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
isAlignLeft | 左侧对齐 | 数据 | boolean | 左侧对齐 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
获取左侧像素模式
获取左侧像素模式：返回左侧边距是否以像素为单位。 true=像素值；false=相对父节点宽度的百分比。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetGetIsAbsoluteLeft |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
isAbsoluteLeft | 左侧像素模式 | 数据 | boolean | 左侧像素模式 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
立即刷新对齐
立即刷新对齐：在当前帧内立即执行 Widget 的对齐计算并应用结果。 修改 Widget 参数后，如果需要在当前帧内立刻读取最新的布局位置和尺寸，就应主动调用此节点。它不是单纯修改配置，而是用来在当前帧内立刻拿到最新对齐结果。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetUpdateAlignment |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置垂直居中对齐
设置垂直居中对齐开关：控制 Widget 是否启用垂直居中对齐。 启用后会取消顶部和底部对齐。垂直居中偏移值只有在此开关开启时才生效。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetSetIsAlignVerticalCenter |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
isAlignVerticalCenter | 垂直居中对齐 | 数据 | boolean | 垂直居中对齐 | 开关 默认值：false | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置垂直居中偏移
设置垂直居中偏移：设置 Widget 的垂直居中偏移值。 仅在垂直居中对齐开启时生效。允许负值（向上偏移）。true=像素值，false=相对父节点高度的百分比偏移。 典型用途：微调 UI 面板的垂直居中位置。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetSetVerticalCenter |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
verticalCenter | 垂直居中偏移 | 数据 | number | 垂直居中偏移 | 输入框 默认值：0 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置垂直居中像素模式
设置垂直居中像素模式：控制垂直居中偏移使用像素还是百分比。 true=像素值；false=相对父节点高度的百分比。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetSetIsAbsoluteVerticalCenter |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
isAbsoluteVerticalCenter | 垂直居中像素模式 | 数据 | boolean | 垂直居中像素模式 | 开关 默认值：true | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置底部边距
设置底部边距：设置 Widget 的底部边距值。 仅在底部对齐开启时生效。允许负值（向下偏移）。true=像素值，false=相对父节点高度的百分比。 典型用途：调整 UI 面板距离屏幕底部的间距。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetSetBottom |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
bottom | 底部边距 | 数据 | number | 底部边距 | 输入框 默认值：0 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置底部对齐
设置底部对齐开关：控制 Widget 是否启用底部对齐。 启用后节点底部边距参与对齐计算。同时启用顶部和底部对齐 = 垂直拉伸。启用垂直居中时会取消顶部和底部对齐。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetSetIsAlignBottom |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
isAlignBottom | 底部对齐 | 数据 | boolean | 底部对齐 | 开关 默认值：false | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置底部像素模式
设置底部像素模式：控制底部边距使用像素还是百分比。 true=像素值；false=相对父节点高度的百分比。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetSetIsAbsoluteBottom |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
isAbsoluteBottom | 底部像素模式 | 数据 | boolean | 底部像素模式 | 开关 默认值：true | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置顶部边距
设置顶部边距：设置 Widget 的顶部边距值。 仅在顶部对齐开启时生效。允许负值（向上偏移）。true=像素值，false=相对父节点高度的百分比。 典型用途：调整 UI 面板距离屏幕顶部的间距。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetSetTop |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
top | 顶部边距 | 数据 | number | 顶部边距 | 输入框 默认值：0 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置顶部对齐
设置顶部对齐开关：控制 Widget 是否启用顶部对齐。 启用后节点顶部边距参与对齐计算。同时启用顶部和底部对齐 = 垂直拉伸。启用垂直居中时会自动关闭顶部和底部对齐。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetSetIsAlignTop |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
isAlignTop | 顶部对齐 | 数据 | boolean | 顶部对齐 | 开关 默认值：false | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置顶部像素模式
设置顶部像素模式：控制顶部边距使用像素还是百分比。 true=像素值；false=相对父节点高度的百分比。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetSetIsAbsoluteTop |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
isAbsoluteTop | 顶部像素模式 | 数据 | boolean | 顶部像素模式 | 开关 默认值：true | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置对齐模式
设置对齐模式：设置 Widget 的对齐刷新模式。 0=ONCE（首次启用时对齐一次，之后不再自动对齐） 1=ALWAYS（每帧始终保持对齐） 2=ON_WINDOW_RESIZE（窗口尺寸变化时重新对齐，其余时间不自动对齐）
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetSetAlignMode |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
alignMode | 对齐模式 | 数据 | number | 对齐模式 ONCE 首次对齐一次 ALWAYS 始终保持对齐 ON_WINDOW_RESIZE 窗口变化时重新对齐 | 下拉选择 默认值：2 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置对齐目标
设置对齐目标：设置 Widget 的对齐目标节点。 target 只能是当前节点的某个父节点。传入 null 表示回退到使用当前父节点作为对齐参考。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetSetTarget |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
target | 目标节点 | 数据 | cc.Node | 对齐目标节点 只能是当前节点的某个父节点，传入 null 表示使用当前父节点 | - | 可选 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置水平居中对齐
设置水平居中对齐开关：控制 Widget 是否启用水平居中对齐。 启用后会取消左侧和右侧对齐。水平居中偏移值只有在此开关开启时才生效。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetSetIsAlignHorizontalCenter |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
isAlignHorizontalCenter | 水平居中对齐 | 数据 | boolean | 水平居中对齐 | 开关 默认值：false | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置水平居中偏移
设置水平居中偏移：设置 Widget 的水平居中偏移值。 仅在水平居中对齐开启时生效。允许负值（向左偏移）。true=像素值，false=相对父节点宽度的百分比偏移。 典型用途：微调 UI 面板的水平居中位置。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetSetHorizontalCenter |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
horizontalCenter | 水平居中偏移 | 数据 | number | 水平居中偏移 | 输入框 默认值：0 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置水平居中像素模式
设置水平居中像素模式：控制水平居中偏移使用像素还是百分比。 true=像素值；false=相对父节点宽度的百分比。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetSetIsAbsoluteHorizontalCenter |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
isAbsoluteHorizontalCenter | 水平居中像素模式 | 数据 | boolean | 水平居中像素模式 | 开关 默认值：true | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置所有属性
一次性批量修改 Widget 组件的多个常用属性。 公开引脚语义（重要）：除 exe 与 widget 外，所有可写属性引脚默认不公开（isPublic: false），只有被显式公开的引脚才参与写入。若想保留目标属性原值不变，必须保持引脚不公开——仅断开连线不够，已公开的引脚会用内联控件默认值覆盖原值。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetSetProperties |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
target | 目标节点 | 数据 | cc.Node | 对齐目标节点 Widget 的对齐目标。默认不公开；公开后才参与写入。 | - | 可选 默认隐藏 |
alignMode | 对齐模式 | 数据 | number | 对齐模式 0=ONCE 1=ALWAYS 2=ON_WINDOW_RESIZE。默认不公开；公开后才参与写入。 | 下拉选择 默认值：2 | 可选 默认隐藏 |
isAlignTop | 顶部对齐 | 数据 | boolean | 顶部对齐 默认不公开；公开后才参与写入。 | 开关 默认值：false | 可选 默认隐藏 |
isAlignBottom | 底部对齐 | 数据 | boolean | 底部对齐 默认不公开；公开后才参与写入。 | 开关 默认值：false | 可选 默认隐藏 |
isAlignLeft | 左侧对齐 | 数据 | boolean | 左侧对齐 默认不公开；公开后才参与写入。 | 开关 默认值：false | 可选 默认隐藏 |
isAlignRight | 右侧对齐 | 数据 | boolean | 右侧对齐 默认不公开；公开后才参与写入。 | 开关 默认值：false | 可选 默认隐藏 |
isAlignVerticalCenter | 垂直居中对齐 | 数据 | boolean | 垂直居中对齐 默认不公开；公开后才参与写入。 | 开关 默认值：false | 可选 默认隐藏 |
isAlignHorizontalCenter | 水平居中对齐 | 数据 | boolean | 水平居中对齐 默认不公开；公开后才参与写入。 | 开关 默认值：false | 可选 默认隐藏 |
top | 顶部边距 | 数据 | number | 顶部边距 默认不公开；公开后才参与写入。 | 输入框 默认值：0 | 可选 默认隐藏 |
bottom | 底部边距 | 数据 | number | 底部边距 默认不公开；公开后才参与写入。 | 输入框 默认值：0 | 可选 默认隐藏 |
left | 左侧边距 | 数据 | number | 左侧边距 默认不公开；公开后才参与写入。 | 输入框 默认值：0 | 可选 默认隐藏 |
right | 右侧边距 | 数据 | number | 右侧边距 默认不公开；公开后才参与写入。 | 输入框 默认值：0 | 可选 默认隐藏 |
horizontalCenter | 水平居中偏移 | 数据 | number | 水平居中偏移 默认不公开；公开后才参与写入。 | 输入框 默认值：0 | 可选 默认隐藏 |
verticalCenter | 垂直居中偏移 | 数据 | number | 垂直居中偏移 默认不公开；公开后才参与写入。 | 输入框 默认值：0 | 可选 默认隐藏 |
isAbsoluteTop | 顶部像素模式 | 数据 | boolean | 顶部像素模式 默认不公开；公开后才参与写入。 | 开关 默认值：true | 可选 默认隐藏 |
isAbsoluteBottom | 底部像素模式 | 数据 | boolean | 底部像素模式 默认不公开；公开后才参与写入。 | 开关 默认值：true | 可选 默认隐藏 |
isAbsoluteLeft | 左侧像素模式 | 数据 | boolean | 左侧像素模式 默认不公开；公开后才参与写入。 | 开关 默认值：true | 可选 默认隐藏 |
isAbsoluteRight | 右侧像素模式 | 数据 | boolean | 右侧像素模式 默认不公开；公开后才参与写入。 | 开关 默认值：true | 可选 默认隐藏 |
isAbsoluteHorizontalCenter | 水平居中像素模式 | 数据 | boolean | 水平居中像素模式 默认不公开；公开后才参与写入。 | 开关 默认值：true | 可选 默认隐藏 |
isAbsoluteVerticalCenter | 垂直居中像素模式 | 数据 | boolean | 垂直居中像素模式 默认不公开；公开后才参与写入。 | 开关 默认值：true | 可选 默认隐藏 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置右侧边距
设置右侧边距：设置 Widget 的右侧边距值。 仅在右侧对齐开启时生效。允许负值（向右偏移）。true=像素值，false=相对父节点宽度的百分比。 典型用途：调整 UI 面板距离屏幕右边缘的间距。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetSetRight |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
right | 右侧边距 | 数据 | number | 右侧边距 | 输入框 默认值：0 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置右侧对齐
设置右侧对齐开关：控制 Widget 是否启用右侧对齐。 启用后节点右侧边距参与对齐计算。同时启用左侧和右侧对齐 = 水平拉伸。启用水平居中时会取消左侧和右侧对齐。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetSetIsAlignRight |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
isAlignRight | 右侧对齐 | 数据 | boolean | 右侧对齐 | 开关 默认值：false | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置右侧像素模式
设置右侧像素模式：控制右侧边距使用像素还是百分比。 true=像素值；false=相对父节点宽度的百分比。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetSetIsAbsoluteRight |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
isAbsoluteRight | 右侧像素模式 | 数据 | boolean | 右侧像素模式 | 开关 默认值：true | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置左侧边距
设置左侧边距：设置 Widget 的左侧边距值。 仅在左侧对齐开启时生效。允许负值（向左偏移）。true=像素值，false=相对父节点宽度的百分比。 典型用途：调整 UI 面板距离屏幕左边缘的间距。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetSetLeft |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
left | 左侧边距 | 数据 | number | 左侧边距 | 输入框 默认值：0 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置左侧对齐
设置左侧对齐开关：控制 Widget 是否启用左侧对齐。 启用后节点左侧边距参与对齐计算。同时启用左侧和右侧对齐 = 水平拉伸。启用水平居中时会取消左侧和右侧对齐。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetSetIsAlignLeft |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
isAlignLeft | 左侧对齐 | 数据 | boolean | 左侧对齐 | 开关 默认值：false | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置左侧像素模式
设置左侧像素模式：控制左侧边距使用像素还是百分比。 true=像素值；false=相对父节点宽度的百分比。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | widgetSetIsAbsoluteLeft |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | Widget |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件。Widget 负责基于父节点或目标节点自动对齐当前节点的位置与尺寸。 | - | 必填 |
isAbsoluteLeft | 左侧像素模式 | 数据 | boolean | 左侧像素模式 | 开关 默认值：true | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
widget | Widget | 数据 | cc.Component / Widget | 目标 Widget 要操作的 Widget 组件 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。