smartJS 0.1 API 讲解 - PromiseEvent

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

PromiseEvent

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

接口方法

smartJS 0.1 API 讲解 - PromiseEvent
var events = st.promiseEvent(mode);

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

event.fire(arg,...);
smartJS 0.1 API 讲解 - PromiseEvent


参数说明

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() 拒绝契约

使用样例

普通方式

smartJS 0.1 API 讲解 - PromiseEvent
    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‘);
    
smartJS 0.1 API 讲解 - PromiseEvent

 

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

smartJS 0.1 API 讲解 - PromiseEvent
 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();
smartJS 0.1 API 讲解 - PromiseEvent

 

stopProgation,停止后续回调

smartJS 0.1 API 讲解 - PromiseEvent
//stopProgation,停止后续回调
    calls.add(‘stop‘,function(e){
        e.stopPropagation();
        result.push("stop");
    },20)
    
    //执行,结果 [50,stop]
    calls.fire();
smartJS 0.1 API 讲解 - PromiseEvent


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

smartJS 0.1 API 讲解 - PromiseEvent
    //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‘);
smartJS 0.1 API 讲解 - PromiseEvent

 

Prmose模式,

可以与jquery的promise结合使用 

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

})

smartJS 0.1 API 讲解 - PromiseEvent
//清除回调
    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();
smartJS 0.1 API 讲解 - PromiseEvent


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

smartJS 0.1 API 讲解 - PromiseEvent
//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 0.1 API 讲解 - PromiseEvent


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

 

 

 

  

 

  

 

smartJS 0.1 API 讲解 - PromiseEvent,布布扣,bubuko.com

smartJS 0.1 API 讲解 - PromiseEvent

上一篇:window常见事件


下一篇:Windows RC版、RTM版、OEM版、RTL版、VOL版的区别