queue() 用來查看或操作元素上的函式佇列。它不是天天會用到的 API,但在需要嚴格控制動畫與非動畫操作的先後順序時,幾乎是唯一正解。建議與 dequeue() 一起學習。
$("selector").queue(queueName)
參數 queueName 可選,預設為 "fx"(動畫佇列)。不帶參數時,回傳第一個匹配元素上的動畫佇列。
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>queue() 方法</title>
<style type="text/css">
.box{
width:300px;
height:150px;
}
.mytest{
width:50px;
height:50px;
background-color:green;
position:absolute;
left:0px;
display:none;
font-size:12px;
}
</style>
<script type="text/javascript" src="jquery-1.8.3.js"></script>
<script type="text/javascript">
$(document).ready(function(){
$("#do").click(function(){
$(".mytest").show(1000);
$(".mytest").animate({left:"+=200"},3000);
$(".mytest").animate({top:"+=50"},2000);
$(".mytest").text("動畫完成");
});
$("#count").click(function(){
alert($(".mytest").queue().length);
});
});
</script>
</head>
<body>
<div class="box">
<div class="mytest"></div>
</div>
<button id="do">點擊開始動畫</button>
<button id="count">計算佇列中函數數量</button>
</body>
</html>
點擊「計算佇列中函數數量」可以隨時看到目前還有幾段動畫在排隊。
上面的程式看起來很正常,但實際執行會發現:「動畫完成」這四個字幾乎立刻就出現了,而不是等動畫跑完才出現。原因是 show() 與 animate() 會自動進入 fx 佇列排隊,而 text() 不是動畫函式,它不會入隊,而是立即執行。這正是佇列機制最容易讓人誤判的地方。
$("selector").queue(callback())
參數 callback 就是要掛到佇列最後面的函式。修正後的寫法:
$("#do").click(function(){
$(".mytest").show(1000);
$(".mytest").animate({left:"+=200"},3000);
$(".mytest").animate({top:"+=50"},2000);
$(".mytest").queue(function(){
$(this).text("動畫完成");
});
});
這樣「動畫完成」就會老實地排在三段動畫之後,等前面全部跑完才寫進元素。
再看一個進階案例。若我們想在自訂函式之後再接一段動畫:
$(".mytest").queue(function(){
$(this).text("動畫還將持續");
});
$(".mytest").animate({left:"-=200"},3000);
結果會發現最後那段 animate 根本沒有執行。原因是:手動用 queue() 加入的函式,jQuery 不會自動幫你推進佇列。修正方式是自行呼叫 dequeue():
$(".mytest").queue(function(){
$(this).text("動畫還將持續");
$(this).dequeue(); // 關鍵:交棒給下一個排隊的函式
});
$(".mytest").animate({left:"-=200"},3000);
這是一條值得記死的規則:凡是透過 queue() 手動加入的函式,都必須在函式結尾呼叫 .dequeue(),否則整條佇列會卡在那裡,後續的動畫與函式永遠等不到執行機會。