监听和发射事件

监听事件

cc.Node）中完成的。对于组件，可以通过访问节点 this.node 来注册和监听事件。监听事件可以 通过 this.node.on() 函数来注册，方法如下：

  1. cc.Class({  extends: cc.Component,  properties: {  },  onLoad: function () {    this.node.on('mousedown', function ( event ) {      console.log('Hello!');    });  },  });

on 可以传第三个参数 target，用于绑定响应函数的调用者。以下两种调用方式， 效果上是相同的：

  1. // 使用函数绑定this.node.on('mousedown', function ( event ) {  this.enabled = false;}.bind(this));// 使用第三个参数this.node.on('mousedown', function (event) {  this.enabled = false;}, this);

on 监听，我们还可以使用 once 方法。once 监听在监听函数响应后就会关闭监听事件。

关闭监听

off 方法关闭对应的监听事件。需要注意的是，off 方法的 参数必须和 on 方法的参数一一对应，才能完成关闭。 我们推荐的书写方法如下：

  1. cc.Class({  extends: cc.Component,  _sayHello: function () {    console.log('Hello World');  },  onEnable: function () {    this.node.on('foobar', this._sayHello, this);  },  onDisable: function () {    this.node.off('foobar', this._sayHello, this);  },});

发射事件

emit 和 dispatchEvent。两者的区别在于，后者可以做事件传递。 我们先通过一个简单的例子来了解 emit 事件：

  1. cc.Class({  extends: cc.Component,  onLoad: function () {    this.node.on('say-hello', function (event) {      console.log(event.detail.msg);    });  },  start: function () {    this.node.emit('say-hello', {      msg: 'Hello, this is Cocos Creator',    });  },});

派送事件

dispatchEvent 方法，通过该方法发射的事件，会进入事件派送阶段。在 Cocos Creator 的事件派送系统中，我们采用冒泡派送的方式。冒泡派送会将事件从事件发起节点，不断地向上传递给他的父级节点，直到到达根节点或者在某个节点的响应函数中做了中断处理 event.stopPropagation()。 事件会经由 c 依次传递给 b，a 节点。如：

  1. // 节点 c 的组件脚本中this.node.dispatchEvent( new cc.Event.EventCustom('foobar', true) );

event.stopPropagation() 函数来完成。具体方法如下：

  1. // 节点 b 的组件脚本中this.node.on('foobar', function (event) {  event.stopPropagation();});

cc.Event 对象，因为它是一个抽象类，请创建 cc.Event.EventCustom 对象来进行派发。

事件对象

cc.Event 类型的事件对象 event，stopPropagation 就是 cc.Event 的标准 API，其它重要的 API 包含： cc.Event 及其子类的 API 文档。

系统内置事件

以上是通用的事件监听和发射规则，在 Cocos Creator 中，我们默认支持了一些系统内置事件，可以参考我们后续的文档来查看如何使用：

  • 节点系统事件文档
  • 全局系统事件文档