使用指南
Cocos 组件 / UI / UIOpacity节点
Cocos 组件 / UI / UIOpacity 节点手册，包含 2 个节点的用途、引脚、使用场景和注意事项。
16
学习目标
访问 Cocos Creator 组件的属性、方法和事件，把引擎能力转成可视化工作流。
覆盖范围
- 节点数量：2
- 分类路径：Cocos 组件 / UI / UIOpacity
典型使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
通用注意事项
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
- 部分组件能力受 Cocos Creator 版本限制，页面会标出版本字段。
节点索引
| 节点 | 节点 ID | 输入/输出 | 执行方式 |
|---|---|---|---|
| 获取透明度 | uiOpacityGetOpacity | 1 / 1 | 立即继续 |
| 设置透明度 | uiOpacitySetOpacity | 3 / 2 | 立即继续 |
获取透明度
获取透明度：返回 UIOpacity 组件控制的当前透明度值。 取值范围：0（完全透明）~ 255（完全不透明）。 影响范围：该透明度会影响当前节点及其所有子节点的 UI 渲染。若节点自身已有图片组件，最终表现会与图片本身的透明度叠加计算。 生效前提：UIOpacity 需要位于 Canvas 或 RenderRoot2D 的 UI 渲染体系下才会生效。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | uiOpacityGetOpacity |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | UIOpacity |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
uiOpacity | 透明度组件 | 数据 | cc.Component / UIOpacity | 目标 UIOpacity 组件 用于控制 UI 节点及其子树的整体透明度 | - | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
opacity | 透明度 | 数据 | number | 透明度 0=完全透明，255=完全不透明 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。
设置透明度
设置透明度：控制 UIOpacity 组件的透明度值。 取值范围：0（完全透明）~ 255（完全不透明）。建议在此范围内赋值以确保效果符合预期。 影响范围：该透明度会影响当前节点及其所有子节点的 UI 渲染。若节点自身已有图片组件，最终表现会与图片本身的透明度叠加计算。 典型用途：淡入/淡出 UI 面板、隐藏/显示游戏提示、渐显按钮等。 生效前提：UIOpacity 需要位于 Canvas 或 RenderRoot2D 的 UI 渲染体系下才会生效。
节点信息
| 字段 | 值 |
|---|---|
| 节点 ID | uiOpacitySetOpacity |
| 分类 | Cocos 组件 |
| 二级分类 | UI |
| 分组 | UIOpacity |
| 是否需要等待结果 | 否 |
| 是否需要先选择目标 | 否 |
输入引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
exe | - | 执行流 | 执行流 | 执行入口 | - | 可选 |
uiOpacity | 透明度组件 | 数据 | cc.Component / UIOpacity | 目标 UIOpacity 组件 用于控制 UI 节点及其子树的整体透明度 | - | 必填 |
opacity | 透明度 | 数据 | number | 透明度 0=完全透明，255=完全不透明 | 输入框 默认值：255 | 必填 |
输出引脚
| 引脚 ID | 名称 | 连接方式 | 值类型 | 用途 | 默认或选择 | 连接要求 |
|---|---|---|---|---|---|---|
out | - | 执行流 | 执行流 | 执行完成 | - | 可选 |
uiOpacity | 透明度组件 | 数据 | cc.Component / UIOpacity | 目标 UIOpacity 组件 用于控制 UI 节点及其子树的整体透明度 | - | 可选 |
使用场景
- 控制 UI、音频、动画、物理、灯光、粒子和渲染组件
- 读取组件状态后驱动游戏逻辑
- 批量设置组件属性完成游戏运行时效果
注意事项
- 适合的工作流类型：component、library、method、function、class。
- 目标组件引脚必须连接正确的组件实例。
- 设置类节点通常需要接入执行流，才会真正修改游戏运行时状态。