上篇简单的介绍smartjs了一些通用方法的api。这篇介绍基础的PromiseEvent(这个名字一直没想好,以前准备用callbacks的,但避免与jquery混淆,st的命名空间可以直接挂到$上)

PromiseEvent

基于事件和promise的回调管理,类似于jquery的callbacks,但具有结果传递,优先级,事件参数,promise控制等功能

接口方法

var events = st.promiseEvent(mode);

events.add(name,function(e,arg,……){

},priority,eventMode)

event.fire(arg,...);

参数说明

mode :once和callback两种模式,(callback模式不会加入事件参数)

e.stopProgation() 阻止后续回调

   event.add(name,fn,priority,eventMode) 添加事件回调, name :加入的事件回调名称; priority :权重设置 ;eventMode :加入的事件模式;once;

  event.fire(arg,,,,) 执行事件回调

  event.fireWith(context,[args]) 使用上下文回调

  event.has(name) 根据回调名称判断是否已注册回调

  event.remove(name) 根据名称删除回调

  event.clear()   清除所有回调

  

  e事件参数

e.result 上一个回调的结果

e.remove() 删除当前回调

e.promise() 返回契约

e.resolve() 解决契约

e.reject() 拒绝契约

使用样例

普通方式

    var calls = st.promiseEvent(),
result = []; //测试使用once模式,执行一次既销毁
calls.add('call1', function(e, text) {
result.push(text+'1');
},"once") calls.add('call2', function(e, text) {
//效果同“once”
e.remove()
result.push(text+'2');
}) //执行,结果 [call1,call2]
calls.fire('call');

权重,默认权重为0,可以通过st.conf({defPriority:100})来设置,相同权重先入先出

 result = [];
//权重
calls.add('p', function(e, text) {
result.push('def');
}) calls.add('p10', function(e, text) {
result.push(10);
},10) calls.add('p50', function(e, text) {
result.push(50);
},50) calls.add('pDef', function(e, text) {
result.push('def2');
}) //执行,结果 [50,10,def,def2]
calls.fire();

stopProgation,停止后续回调

//stopProgation,停止后续回调
calls.add('stop',function(e){
e.stopPropagation();
result.push("stop");
},20) //执行,结果 [50,stop]
calls.fire();

结果传递,promiseEvent回将return的结果或者resolve的非undefined的结果记录下来并向下传递;

    //result传递模式
calls.add('c1', function(e, text) {
return text + "-c1";
}) calls.add('c2', function(e, text) {
return e.result + "-c2";
}) calls.add('c3', function(e, text) {
return e.result + "-c3";
}) //执行,结果 test-c1-c2-c3
calls.fire('test');

Prmose模式,

可以与jquery的promise结合使用

$.when(calls.fire()).done(function(result){

})

//清除回调
calls.clear();
result = []; //promise模式
calls.add("c1", function(e) {
setTimeout(function() {
result.push("c1");
e.resolve();
}, 100);
return e.promise();
}); calls.add("c2", function(e) {
result.push("c2");
}); //执行,结果 [c1,c2]
calls.fire();

mode设置,once(执行及销毁)和callback(简单回调)

//callback模式 & once模式
var calls2 = st.promiseEvent("callback once"); //callback不存在e事件参数,只是具有见的回调管理
calls2.add('c1', function(text) {
return text + "-c1";
}) //执行第一次,结果 test-c1
calls2.fire('test'); //执行第二次,因为once模式,结果 undefined
calls2.fire('test');

更多的例子请参考smartjs上的测试用例

  

  

05-11 22:37