.queue()
.queue( [ queueName ] ) 返回: Array
描述: 显示在匹配的元素上的已经执行的函数列队。
-
version added: 1.2.queue( [ queueName ] )
queueName一个含有队列名的字符串。默认是"Fx",标准的动画队列。
Example:
显示列队的长度。
<!DOCTYPE html>
<html>
<head>
<style>div { margin:3px; width:40px; height:40px;
position:absolute; left:0px; top:60px;
background:green; display:none; }
div.newcolor { background:blue; }
p { color:red; } </style>
<script src="http://code.jquery.com/jquery-latest.min.js"></script>
</head>
<body>
<button id="show">Show Length of Queue</button>
<p></p>
<div></div>
<script>$("#show").click(function () {
var n = $("div").queue("fx");
$("p").text("Queue length is: " + n.length);
});
function runIt() {
$("div").show("slow");
$("div").animate({left:'+=200'},2000);
$("div").slideToggle(1000);
$("div").slideToggle("fast");
$("div").animate({left:'-=200'},1500);
$("div").hide("slow");
$("div").show(1200);
$("div").slideUp("normal", runIt);
}
runIt();</script>
</body>
</html>
Demo:
.queue( [ queueName ], newQueue ) 返回: jQuery
描述: 在匹配元素上操作已经附加函数的列表。
-
version added: 1.2.queue( [ queueName ], newQueue )
queueName一个含有队列名的字符串。默认是"Fx",标准的动画队列。
newQueue一个替换当前函数列队内容的数组。
-
version added: 1.2.queue( [ queueName ], callback( next ) )
queueName一个含有队列名的字符串。默认是
fx
,标准的动画队列。callback( next )添加到列队的新函数。
每个元素可以通过jQuery包含一个或多个函数队列。在大多数应用中,只有一个列队(访问 fx
)被使用。队列允许一个元素来异步的访问一连串的动作,而不终止程序执行。典型的例子就是在一个元素上调用多重动画的方法对一个元素。例如:
$('#foo').slideUp().fadeIn();
当这个语句被执行,这个元素开始立即做滑动动画,但渐入动画放置在 fx
列队在,只有当滑动动画完成后才会被执行。
queue()
方法允许我们直接操纵这个函数队列。用一个回调函数访问queue()
特别的有用;它让我们把新函数置入到队列的末端。
此特征是提供一个回调函数和动画的方法类似 ,但并不需要回调函数给定当时的执行动画。
$('#foo').slideUp(); $('#foo').queue(function() { alert('Animation complete.'); $(this).dequeue(); });
This is equivalent to:
$('#foo').slideUp(function() { alert('Animation complete.'); });
值得注意的是,当使用queue()
添加一个函数的时候,我们必须保证jQuery.dequeue()
让下一个函数执行后被呼叫 。
在jQuery 1.4中这个函数通过另一个函数调用的。作为第一个参数,他将调用自动执行下一项而且保持列队移动。你可以这样使用:
$("#test").queue(function(next) { // Do some stuff... next(); });
例子:
举例: Queue a custom function.
<!DOCTYPE html>
<html>
<head>
<style>
div { margin:3px; width:40px; height:40px;
position:absolute; left:0px; top:30px;
background:green; display:none; }
div.newcolor { background:blue; }
</style>
<script src="http://code.jquery.com/jquery-latest.min.js"></script>
</head>
<body>
Click here...
<div></div>
<script>$(document.body).click(function () {
$("div").show("slow");
$("div").animate({left:'+=200'},2000);
$("div").queue(function () {
$(this).addClass("newcolor");
$(this).dequeue();
});
$("div").animate({left:'-=200'},500);
$("div").queue(function () {
$(this).removeClass("newcolor");
$(this).dequeue();
});
$("div").slideUp();
});</script>
</body>
</html>
Demo:
Example: Set a queue array to delete the queue.
<!DOCTYPE html>
<html>
<head>
<style>
div { margin:3px; width:40px; height:40px;
position:absolute; left:0px; top:30px;
background:green; display:none; }
div.newcolor { background:blue; }
</style>
<script src="http://code.jquery.com/jquery-latest.min.js"></script>
</head>
<body>
<button id="start">Start</button>
<button id="stop">Stop</button>
<div></div>
<script>$("#start").click(function () {
$("div").show("slow");
$("div").animate({left:'+=200'},5000);
$("div").queue(function () {
$(this).addClass("newcolor");
$(this).dequeue();
});
$("div").animate({left:'-=200'},1500);
$("div").queue(function () {
$(this).removeClass("newcolor");
$(this).dequeue();
});
$("div").slideUp();
});
$("#stop").click(function () {
$("div").queue("fx", []);
$("div").stop();
});</script>
</body>
</html>