Button（按钮）组件参考

Button 组件可以响应用户的点击操作，当用户点击 Button 时，Button 自身会有状态变化。另外，Button 还可以让用户在完成点击操作后响应一个自定义的行为。

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

Button 属性

Button Transition

Button 的 Transition 用来指定当用户点击 Button 时的状态表现。目前主要有 NONE，COLOR，SPRITE 和 SCALE。

Color Transition

Sprite Transition

Scale Transition

详细说明

Button 目前只支持 Click 事件，即当用户点击并释放 Button 时才会触发相应的回调函数。

组件事件结构

通过脚本代码添加回调

方法一

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

import { _decorator, Component, Event, Node, ButtonComponent } from "cc";
const { ccclass, property } = _decorator;
@ccclass("example")
export class example extends Component {
    onLoad(){
        const clickEventHandler = new cc.Component.EventHandler();
        clickEventHandler.target = this.node; //这个 node 节点是你的事件处理代码组件所属的节点
        clickEventHandler.component = 'example';//这个是代码文件名
        clickEventHandler.handler = 'callback';
        clickEventHandler.customEventData = 'foobar';
        const button = this.node.getComponent(ButtonComponent);
        button.clickEvents.push(clickEventHandler);
    }
    callback(event: Event, customEventData: string){
        //这里 event 是一个 Touch Event 对象，你可以通过 event.target 取到事件的发送节点
        const node = event.target as Node;
        const button = node.getComponent(ButtonComponent);
        console.log(customEventData); // foobar
    }
}

方法二

通过 button.node.on('click', …) 的方式来添加，这是一种非常简便的方式，但是该方式有一定的局限性，在事件回调里面无法获得当前点击按钮的屏幕坐标点。

//假设我们在一个组件的 onLoad 方法里面添加事件处理回调，在 callback 函数中进行事件处理:
import { _decorator, Component, ButtonComponent } from "cc";
const { ccclass, property } = _decorator;
@ccclass("example")
export class example extends Component {
    @property(ButtonComponent)
    button: ButtonComponent | null = null;
    onLoad(){
        this.button.node.on('click', this.callback, this);
    }
    callback(button: ButtonComponent){
        // 注意这种方式注册的事件，无法传递 customEventData
    }
}

其他基础模块参考

渲染模块参考