• ToggleContainer 组件参考
    • ToggleContainer 属性
    • ToggleContainer 事件
    • 详细说明
    • 通过脚本代码添加回调
      • 其他基础模块参考
      • 渲染模块参考

    ToggleContainer 组件参考

    toggle-container

    ToggleContainer 不是一个可见的 UI 组件,它可以用来修改一组 Toggle 组件的行为。当一组 Toggle 属于同一个 ToggleContainer 的时候,任何时候只能有一个 Toggle 处于选中状态。

    注意:所有包含 Toggle 组件的一级子节点都会自动被添加到该容器中

    点击 属性检查器 下面的 添加组件 按钮,然后从 添加 UI 组件 中选择 ToggleContainer,即可添加 ToggleContainer 组件到节点上。

    ToggleContainer 属性

    属性功能说明
    AllowSwitchOff如果这个设置为 true, 那么 toggle 按钮在被点击的时候可以反复地被选中和未选中。
    CheckEvents选中事件。列表类型,默认为空,用户添加的每一个事件由节点引用,组件名称和一个响应函数组成。

    ToggleContainer 事件

    事件结构参考:组件事件结构 |

    ToggleContainer 的事件回调有二个参数,第一个参数是 Toggle 本身, 第二个参数是 customEventData。

    详细说明

    ToggleContainer 一般不会单独使用,它需要与 Toggle 配合使用来实现 RadioButton 的单选效果。

    通过脚本代码添加回调

    这种方法添加的事件回调和使用编辑器添加的事件回调是一样的,都是通过代码添加。首先需要构造一个 cc.Component.EventHandler 对象,然后设置好对应的 targetcomponenthandlercustomEventData 参数。

    1. import { _decorator, Component, Event, Node, ToggleContainerComponent } from "cc";
    2. const { ccclass, property } = _decorator;
    3. @ccclass("example")
    4. export class example extends Component {
    5. onLoad(){
    6. const containerEventHandler = new cc.Component.EventHandler();
    7. containerEventHandler.target = this.node; // 这个 node 节点是你的事件处理代码组件所属的节点
    8. containerEventHandler.component = 'example';// 这个是代码文件名
    9. containerEventHandler.handler = 'callback';
    10. containerEventHandler.customEventData = 'foobar';
    11. const container = this.node.getComponent(ToggleContainerComponent);
    12. container.checkEvents.push(containerEventHandler);
    13. }
    14. callback(event: Event, customEventData: string){
    15. //这里 event 是一个 Touch Event 对象,你可以通过 event.target 取到事件的发送节点
    16. // 这里的 customEventData 参数就等于之前设置的 'foobar'
    17. }
    18. }

    其他基础模块参考

    渲染模块参考