Question

一个适用于移动端的事件发射器。

Usage

通过edp引入模块：

edp import saber-emitter

简单使用示例：

require( [ 'saber-emitter' ], function( Emitter ) {
    var emitter = new Emitter();

    emitter.on( 'greeting', function( name ) {
        console.log( 'Hello, ' + name + '!' );
    });

    emitter.emit( 'greeting', 'Firede' );
});

API

Emitter

new Emitter

创建Emitter实例。

var emitter = new Emitter();

Emitter.mixin( obj )

通过mixin将Emitter混入目标对象。

var obj = {};
Emitter.mixin( obj );

obj.emit( 'foo' );

Emitter#on( event, listener )

挂载事件。

function listenerFn( name ) {
    console.log( 'Hello ' + name );
}
emitter.on( 'say', listenerFn );

Emitter#once( event, listener )

挂载只执行一次的事件。

emitter.once( 'say', listenerFn );

Emitter#off( event, listener )

注销事件与监听器。

• 任何参数都不传将注销当前实例的所有事件
• 只传入event将注销该事件下挂载的所有监听器
• 传入event与listener将只注销该监听器

emitter.off();
emitter.off( 'say' );
emitter.off( 'say', listenerFn );

Emitter#emit( event, args… )

触发事件。

emitter.emit( 'say' );
emitter.emit( 'say', 'hello' );

Emitter#listeners( event )

返回指定事件的监听器列表。

var listeners = emitter.listeners( 'say' );

Emitter#setMaxListeners( number )

设置每个事件下，监听器的最大个数。为 0 时不限制，默认值是 10 。

emitter.setMaxListeners( 8 );

AspectEmitter

提供了 AOP 支持的事件发射器。

它的使用方式与 Emitter 相同，只是在 emit 增加了对 :before、:after 事件的支持。

注：在事件 on、off、once 时，带 :before/:after 的事件与普通事件无区分，均需手工管理。

var AspectEmitter = require('saber-emitter/aspect');

var emitter = new AspectEmitter();

// 绑定 before、after 事件
emitter.on('foo', doSomething);
emitter.on('foo:before', doSomething);
emitter.on('foo:after', doSomething);

emitter.emit('foo');
// => 按 foo:before, foo, foo:after 顺序触发

emitter.emit('foo:before');
// => 单独触发 foo:before 事件

// 手工解绑事件
emitter.off('foo');
emitter.off('foo:before');
emitter.off('foo:after');

Browser Support

已测试通过的浏览器：

• iOS Safari: 5.0, 5.1, 6.0, 6.1, 7.0
• Android Browser: 2.2, 2.3.3, 4.1
• IE Mobile: 10

,