上篇简单的介绍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上的测试用例