.queue( [queueName ] )
描述:显示或操作匹配的元素上已经执行的函数列队。
- queueName类型:一个含有队列名的字符串。默认是
fx
,标准的动画队列。
例子:
显示列队的长度。
The queue length is:
.queue( [queueName ], newQueue )
描述: 在匹配元素上操作已经附加函数的列表。
- queueName类型:一个含有队列名的字符串。默认是
fx
,标准的动画队列。 - newQueue类型:一个替换当前列队内容的函数数组。
.queue( [queueName ], callback( next ) )
- queueName类型:一个含有队列名的字符串。默认是
fx
,标准的动画队列。 - callback( next )类型: ()将要添加到队列中的新函数。当该函数被调用时,会从弹出队列中的下一个元素。
每个元素可以通过jQuery,包含一个或多个函数队列。在大多数应用中,只有一个列队(访问 fx
)被使用。队列允许一个元素来异步的访问一连串的动作,而不终止程序执行。典型的例子就是在一个元素上调用多重动画的方法对一个元素。例如:
$('#foo').slideUp().fadeIn();
当这个语句被执行,这个元素开始立即做滑动动画,但渐入动画放置在 fx
列队在,只有当滑动动画完成后才会被执行。
queue()
方法允许我们直接操纵这个函数队列。用一个回调函数访问queue()
特别的有用;它让我们把新函数置入到队列的末端。为jQuery集合中的每个元素执行一次回调函数。
该函数的功能类似于在动画方法中提供了回调函数,但是不要求在动画执行时指定回调函数。
$('#foo').slideUp();$('#foo').queue(function() {alert('Animation complete.');$(this).dequeue();});
这是相当于:
$('#foo').slideUp(function() {alert('Animation complete.');});
值得注意的是,当使用.queue()
添加一个函数的时候,我们应该保证在函数最后调用了 jQuery.dequeue()
,这样就能让队列中的其它函数按顺序执行。
从jQuery 1.4开始,向队列中追加函数时,可以向该函数中传入另一个函数,作为第一个参数。当调用函数时,会自动从函数队列中弹出下一个项目,保证队列中函数的继续进行。我们可以像下面这样使用:
$("#test").queue(function(next) {// Do some stuff...next();});
例子:
Example: Queue a custom function.
Click here...
Example: Set a queue array to delete the queue.