Jquery（15）Jquery 回调对象与延迟对象
一、回调对象Callbacks
jQuery 1.7 版本中新增的 jQuery.Callbacks() 函数,返回一个多功能对象，此对象提供了一种强大的方法来管理回调列表。它能够增加、删除、触发、禁用回调函数。
1、定义和用法
$.Callbacks() 指一个多用途的回调函数列表对象，提供了一种强大的方法来管理回调函数列对。
提示： $.Callbacks 是在 jQuery 内部使用，如为 .ajax，$.Deferred 等组件提供基础功能的函数。它也可以用在类似功能的一些组件中，如自己开发的插件。
$(function () { function fn1( value ) { alert( value ); } function fn2( value ) { fn1("fn2 says: " + value); return false; } var callbacks = $.Callbacks(); callbacks.add( fn1 ); callbacks.fire( "foo!" );// 输出: foo! callbacks.add( fn2 ); callbacks.fire( "bar!" );// 先执行f1,再执行f2。输出: bar!, fn2 says: bar! })
2、支持的 Flags 参数
这个 flags 参数是 $.Callbacks() 的一个可选参数， 结构为一个用空格标记分隔的标志可选列表，用来改变回调列表中的行为 (比如. $.Callbacks( \'unique stopOnFalse\' ))。
以下是可用的 flags:
- once：确保这个回调列表只执行一次
- memory：缓存上一次fire时的参数值，当add()添加回调函数时，直接用上一次的参数值立刻调用新加入的回调函数
- unique：一个回调只会被添加一次，不会重复添加
- stopOnFalse：某个回调函数返回false之后中断后面的回调函数
下面是 $.Callbacks( "unique" ) 的一个例子
$(function () { function fn1( value ) { alert( value ); } function fn2( value ) { fn1("fn2 says: " + value); return false; } var callbacks = $.Callbacks( "unique" ); callbacks.add( fn1 ); callbacks.fire( "foo" ); callbacks.add( fn1 ); // repeat addition callbacks.add( fn2 ); callbacks.fire( "bar" ); callbacks.remove( fn2 ); callbacks.fire( "foobar" ); /*输出: foo bar fn2 says:bar foobar */ })
$.Callbacks() 支持一个列表设置多个flags（标识）而不仅仅是一个，有一个累积效应，类似"&&"。
下面是 $.Callbacks( \'unique memory\' ) 的一个例子
$(function () { function fn1( value ) { alert( value ); return false; } function fn2( value ) { fn1( "fn2 says: " + value ); return false; } var callbacks = $.Callbacks( "unique memory" ); callbacks.add( fn1 ); callbacks.fire( "foo" ); callbacks.add( fn1 ); // repeat addition callbacks.add( fn2 ); callbacks.fire( "bar" ); callbacks.add( fn2 ); callbacks.fire( "baz" ); callbacks.remove( fn2 ); callbacks.fire( "foobar" ); /*输出: foo fn2 says:foo bar fn2 says:bar baz fn2 says:baz foobar*/ })
3、方法清单：
- callbacks.add()：回调列表中添加一个回调或回调的集合。
- callbacks.disable()：禁用回调列表中的回调
- callbacks.disabled()：确定回调列表是否已被禁用。
- callbacks.empty()：从列表中删除所有的回调.
- callbacks.fire()：用给定的参数调用所有的回调
- callbacks.fired()：访问给定的上下文和参数列表中的所有回调。
- callbacks.fireWith()：访问给定的上下文和参数列表中的所有回调。
- callbacks.has()：确定列表中是否提供一个回调
- callbacks.lock()：锁定当前状态的回调列表。
- callbacks.locked()：确定回调列表是否已被锁定。
- callbacks.remove()：从回调列表中的删除一个回调或回调集合。
二、延迟对象：deferred
在jQuery 1.5中新增了 Deferred 延迟对象，它是通过调用 jQuery.Deferred() 方法来创建的可链接的实用对象。它可注册多个回调函数到回调列表，调用回调列表并且传递异步或同步功能的成功或失败的状态。
延迟对象是可链接的，类似于一个 jQuery 对象可链接的方式，区别于它有自己的方法。在创建一个 Deferred 对象之后，您可以使用以下任何方法，直接链接到通过调用一个或多个的方法创建或保存的对象。
1、$.Deferred()定义和用法
$.Deferred() 是一个构造函数，用来返回一个链式实用对象方法来注册多个回调，并且调用回调队列，传递任何同步或异步功能成功或失败的状态。
- $.Deferred() 构造函数创建一个新的 Deferred（延迟）对象， jQuery.Deferred 可传递一个可选的函数，该函数在构造方法返回之前被调用并传递一个新的 Deferred 对象作为函数的第一个参数。例如被调用的函数可以使用 deferred.then（）来附加回调函数。
- 一个 Deferred 对象开始于挂起状态。任何使用 deferred.then(), deferred.always(), deferred.done(), 或者 deferred.fail() 添加到这个对象的回调函数都是排队等待执行的。调用 deferred.resolve() 或 eferred.resolveWith() 转换延迟到解决状态后立即执行设置的 doneCallbacks 。调用 deferred.reject() 或 deferred.rejectWith() 转换延迟到拒绝状态后立即执行设置的 failCallbacks 。一旦对象已经进入了解决或拒绝状态，它保持该状态。回调仍然可以添加到已解决或已拒绝的 Deferred 对象——它们会立即执行。
设定两个延时时间是随机的定时器，分别用于解决（resolve）和拒绝（reject）延迟对象
$(function () { function asyncEvent(){ var dfd = new jQuery.Deferred(); // 在一个随机的时间间隔之后 Resolve （解决状态） setTimeout(function(){ dfd.resolve("欢呼"); }, Math.floor(400+Math.random()*2000));
// 在一个随机的时间间隔之后 reject （拒绝状态） setTimeout(function(){ dfd.reject("对不起"); }, Math.floor(400+Math.random()*2000));
// 每半秒显示一个"working..."消息 setTimeout(function working(){ if ( dfd.state() === "pending" ) { dfd.notify("working... "); setTimeout(working, 500); } }, 1); // 返回 Promise 对象，调用者不能改变延迟对象 return dfd.promise(); } // 为异步函数附加一个done, fail, 和 progress 处理程序 $.when( asyncEvent() ).then( function(status){ alert( status+\', 事情进展顺利\' ); }, function(status){ alert( status+\', 这次你失败了\' ); }, function(status){ $("body").append(status); } ); })
2、deferred.promise()：
返回Deferred(延迟)的Promise对象。
- 方法允许一个异步函数阻止那些干涉其内部请求的进度（progress）或状态（status）的其它代码。
- 只包含 deferred 对象的一组方法，包括：done(),then(),fail(),isResolved(), isRejected(), always(), 这些方法只能观察一个 deferred 的状态，而无法更改 deferred 对象的内在状态。
- deferred.promise()也可以接受一个 target 参数，此时传入的 target 将被赋予 Promise 的方法，并作为结果返回，而不是创建一个新对象。
deferred.promise( [target ] ) ：使用目标参数：
3、.promise()：
返回一个 Promise 对象用来观察当某种类型的所有行动绑定到集合，排队与否还是已经完成。
- .promise() 方法返回一个动态生成的 Promise，当绑定到集合中的所有特定动作（action）已经被加入或未被加入到队列中时，生成的 Promise 将被受理（resolve）。
- type 的默认值是"fx" ，这意味着被受理（resolve）的 Promise 对象是在所有被选中元素的动画都完成时返回的。
- 如果提供 target 参数，.promise() 在该参数上添加方法，然后返回这个对象，而不是创建一个新的。它适用于在一个已经存在的对象上添加 Promise 行为的情况。
语法:.promise( [type ] [, target ] )
type:String类型 需要待观察队列类型。
target:PlainObject类型 将要绑定 promise 方法的对象。
在一个没有激活动画的集合上调用 .promise()
$(function () { var div = $( "" ); div.promise().done(function( arg1 ) { alert( this === div && arg1 === div );//弹出 "true" }); })
动画结束时调用受理返回的 Promise
当所有的动画结束时(包括那些在动画回调函数和之后添加的回调函数中初始化的动画），受理（Resolve）返回的 Promise。
$(function () { $( "button" ).on( "click", function() { $( "p" ).append( "已开始..." ); $( "div" ).each(function( i ) { $( this ).fadeIn().fadeOut( 100 * ( i + 1 ) ); }); $( "div" ).promise().done(function() { $( "p" ).append( " 完成! " ); }); }); })
4、jQuery.when()：
提供一种方法来执行一个或多个对象的回调函数， Deferred(延迟)对象通常表示异步事件。
略
5、方法清单：
- deferred.progress()：当Deferred（延迟）对象生成进度通知时，调用添加处理程序。
- deferred.done()：当Deferred（延迟）对象解决时，调用添加处理程序。
- deferred.fail()：当Deferred（延迟）对象拒绝时，调用添加处理程序。
- deferred.always()：当Deferred（延迟）对象解决或拒绝时，调用添加处理程序。
- deferred.catch()：当Deferred对象被拒绝(reject)时，调用添加的处理程序。
- deferred.notify()：根据给定的 args参数 调用Deferred（延迟）对象上进行中的回调 （progressCallbacks）。
- deferred.notifyWith()：根据给定的上下文（context）和args递延调用Deferred（延迟）对象上进行中的回调（progressCallbacks ）。
- deferred.resolve()：解决Deferred（延迟）对象，并根据给定的args参数调用任何完成回调函数（doneCallbacks）。
- deferred.resolveWith()：解决Deferred（延迟）对象，并根据给定的 context和args参数调用任何完成回调函数（doneCallbacks）。
- deferred.reject()：拒绝Deferred（延迟）对象，并根据给定的args参数调用任何失败回调函数（failCallbacks）。
- deferred.rejectWith()：拒绝Deferred（延迟）对象，并根据给定的 context和args参数调用任何失败回调函数（failCallbacks）。
- deferred.pipe()：实用的方法来过滤 and/or 链Deferreds。
- deferred.state()：确定一个Deferred（延迟）对象的当前状态。
- deferred.then()：当Deferred（延迟）对象解决，拒绝或仍在进行中时，调用添加处理程序。