JQuery.Callbacks系列一:api使用详解

JQuery.Callbacks是jQuery1.7+之后引入的,,用来进行函数队列的add、remove、fire、lock等操作,并提供once、memory、unique、stopOnFalse四个option进行一些特殊的控制。既然是新加入的功能,那么就有其特定的使用场景和优势。本文主要是介绍下Callbacks相关API的使用,关于Callbacks的使用场景以及源码等将会在后续博客中进行说明。我使用的JQuery版本是1.11.1

1、创建Callbacks对象

如果要使用Callbacks的相关API,必须要先创建Callbacks对象。创建Callbacks对象的时候,可以指定参数,也可以不指定参数。不同参数值的Callbacks具有不同的功能,后面再介绍,这里只需要知道如何创建Callbacks对象即可。

// 默认方式创建callbackvar callbacks = $.Callbacks();// 4种形式的callback:once、unique、stopOnFalse、memoryvar onceCallbacks = $.Callbacks('once');var uniqueCallbacks = $.Callbacks('unique');var stopOnFalseCallbacks = $.Callbacks('stopOnFalse');var memoryCallbacks = $.Callbacks('memory');还有一点需要说明:每次调用$.Callbacks()方法,返回的都是不同的Callbacks对象。即这是一个工厂方法,每次调用都会新建一个对象,对象之间是相互独立的。var callbacks1 = $.Callbacks();var callbacks2 = $.Callbacks();alert(callbacks1 == callbacks2);//false

2、添加和删除回调函数

Callbacks对象其实就是一个函数队列,获得Callbacks对象之后 ,就可以向这个集合中增加或者删除函数。add和remove功能相反,函数参数是相同的,empty()删除回调列表中的所有函数。

function fn1( value ) { console.log("fn1:" + value );} function fn2( value ) { console.log( "fn2:" + value );} var callbacks = $.Callbacks(); // 方式1:添加1个单独函数 callbacks.add( fn1 ); callbacks.add( fn2 );// 方式2:添加多个函数 callbacks.add(fn1,fn2);// 方式3:添加函数数组 callbacks.add([fn1,fn2]);// 方式4 函数和数组混合 callbacks.add(fn1, [fn2]);可以看到add/remove可以支持多种类型的参数列表,我们可以根据需要自由选择。关于add有几点需要说明:1、同一个函数可以多次通过add()添加到Callbacks中,执行的时候该函数也会多次执行。var callbacks = $.Callbacks();callbacks.add(fn1);callbacks.add(fn1);// 调用callbacks中的函数callbacks.fire("hi!");2、如果add()添加的是匿名函数,那么不能通过remove()删除。var callbacks = $.Callbacks();callbacks.add(functio(){console.log("fn1:" + value );});// not workcallbacks.remove(functio(){console.log("fn1:" + value );});3、如果函数fn1通过add()添加了多次,那么remove()之后,这多次添加都会被删除。callbacks.add( fn1 );callbacks.add( fn1 );callbacks.add( fn2);callbacks.fire( "foo!" );callbacks.remove(fn1,fn2);callbacks.fire( "foo!" );//fn1和fn2都不会再触发4、remove一个不存在的函数没有任何效果var callbacks = $.Callbacks();callbacks.remove(fn1,fn2);

3、触发回调函数

通过fire或firefireWith可以调用回调列表的函数。fire()函数中的参数列表可以传递多个实参,但是不能是参数数组。

function fn(a,b) {console.log("a="+a);console.log("b="+b);}var callbacks = $.Callbacks();callbacks.add(fn);callbacks.fire(1,2);//a=1,b=2callbacks.fire([3,4]);a=[3,4],b=undefinedfireWith的参数列表只能是数组,不能是多个参数(会报类型不匹配的错误)。function fn(a,b) {console.log("a="+a);console.log("b="+b);}var callbacks = $.Callbacks();callbacks.add(fn);// Function.prototype.apply: Arguments list has wrong type callbacks.fireWith(null,[1,2]);//a=1,b=2callbacks.fireWith(null,1,2);fire()和fireWith()还有一个重要区别,fireWith能够改变函数执行上下文,而fire上下文固定是Callbacks对象。什么是函数执行上下文呢?其实就是函数中this到底指代哪儿对象。如果函数中么有this,那么上下文就没有什么作用。function fn(a) {console.log(this);console.log("a="+a); }var callbacks = $.Callbacks();callbacks.add(fn);callbacks.fire(1);//a=1,this就是callbacks对象var me = {"name":"aty","age":26};callbacks.fireWith(me,[2]);//a=2,this是me

4、Callbacks对象的状态判断

判断Calllbacks对象的状态相关API有has()、disabled()、locked()、fired()。

disabled()和locked()判断Callbacks对象是否处于disabled状态或是locked状态。可以通过disable()、locke()改变Callbacks对象的状态。这个地方有点奇怪,一旦将Callbacks禁用或者锁定,那么就无法再恢复。

var callbacks1 = $.Callbacks();callbacks1.lock();console.log(callbacks1.locked());var callbacks2 = $.Callbacks();callbacks2.disable();console.log(callbacks2.disabled());fired()判断Callbacks对象是否调用过fire()或者fireWith()方法。只要在Callbacks对象上调用过一次fire或fireWith,fired()就会一直返回true,否则返回false。

has()的参数是一个函数,用来判断该函数是否已经存在于回调列表中,不想重复添加时很有用。

var callbacks = $.Callbacks();callbacks.has(fn1);//falsecallbacks.add(fn1);callbacks.has(fn1);//true

5、创建Callbcks对象时的4种类型

若不给自己设限,则人生中就没有限制你发挥的藩篱。

JQuery.Callbacks系列一:api使用详解

相关文章:

你感兴趣的文章:

标签云: