queue() 方法用來管理在符合的元素上執行的函式隊列。想讓一連串動畫或 AJAX 依序執行,它就是最直接的答案。
queue 把函式加入隊列(通常是函式陣列)。dequeue 把隊列中的第一個函式取出並執行(內部用 shift())。這意味著再次呼叫 dequeue 時,取到的就是另一個函式了;反過來說,如果不呼叫 dequeue,隊列中的下一個函式永遠不會執行。
值得一提的是,對單一元素呼叫 animate() 時,jQuery 內部也會把它加入名為 fx 的函式隊列,這就是為什麼連續的 animate 會自動排隊播放。但若是多個元素要依序執行動畫,就必須手動建立隊列了。
<div id="block1">div 1</div>
<div id="block2">div 2</div>
<script type="text/javascript">
var FUNC = [
function() { $("#block1").animate({color:"=blue"}, aniCB); },
function() { $("#block2").animate({color:"=red"}, aniCB); },
function() { $("#block1").animate({color:"=yellow"}, aniCB); },
function() { $("#block2").animate({color:"=grey"}, aniCB); },
function() { $("#block1").animate({color:"=green"}, aniCB); },
function() { alert("動畫結束") }
];
var aniCB = function() {
$(document).dequeue("myAnimation");
}
$(document).queue("myAnimation", FUNC)
// aniCB();
</script>
流程說明:
aniCB,用 dequeue 執行隊列中的下一個函式。myAnimation 隊列(放哪個元素都可以,這裡只是為了方便)。這樣做的好處是函式陣列呈線性展開,增減非常直觀。想中途停止後續動畫(例如使用者按了取消),只要清空隊列即可;想加更多步驟,就往隊列裡塞。
// 清空隊列
$(document).queue("myAnimation", []);
// 在尾端加入新函式
$(document).queue("myAnimation", function(){ alert("動畫真的結束了!") });
同樣的技巧也適用於 AJAX。若需要一串請求,每個都要等前一個結束才開始,最原始的做法是層層嵌套回呼,寫起來非常痛苦。改用 queue 之後,只要在每次 AJAX 的回呼中呼叫一次 dequeue,整串流程就自動跑下去了。
var tasks = [
function(){ $.get("/api/step1", next); },
function(){ $.get("/api/step2", next); },
function(){ $.get("/api/step3", function(){ console.log("全部完成"); }); }
];
function next(){ $(document).dequeue("ajaxQueue"); }
$(document).queue("ajaxQueue", tasks).dequeue("ajaxQueue");
理解 queue 最透徹的方式,就是自己刻一個:
function Queue(){
this.a = [];
this.t = null;
}
Queue.prototype = {
queue: function(s){
var self = this;
this.a.push(s);
this.hold();
return this;
},
hold: function(){
var self = this;
clearTimeout(this.t);
this.t = setTimeout(function(){
console.log("Queue start! ", self.a);
self.dequeue();
}, 0);
},
dequeue: function(){
var s = this.a.shift(), self = this;
if (s) {
console.log("s:" + s);
setTimeout(function(){
console.log("end:" + s);
self.dequeue();
}, s);
}
}
};
var a = new Queue().queue(500).queue(200).queue(400).queue(1500).queue(300).queue(2000);
這個簡化版用 setTimeout 模擬動畫的耗時:每次 dequeue 取出一項,等待指定毫秒數後再呼叫自己處理下一項,直到陣列空了自然停下。hold() 裡的 clearTimeout 則對應 jQuery 的「重置計時」行為,避免連續 queue() 時啟動多次。
對照之下就能看出 jQuery 版本多做了哪些事:支援自訂隊列名稱、以 fx 作為動畫專用隊列、以及回傳 jQuery 物件以維持鏈式呼叫。