dequeue() 會從佇列最前端取出一個函式並立即執行它。它等於是在替佇列「踩油門」,因此幾乎總是與 queue() 成對出現。
$(selector).dequeue(queueName)
參數 queueName 可選,用來指定要操作的佇列名稱,預設為 "fx",也就是動畫佇列。
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>dequeue() 方法</title>
<style type="text/css">
div
{
margin:3px;
width:50px;
position:absolute;
height:50px;
left:10px;
top:30px;
background-color:yellow;
}
div.red
{
background-color:red;
}
</style>
<script type="text/javascript" src="jquery-1.8.3.js"></script>
<script type="text/javascript">
$(document).ready(function(){
$("button").click(function(){
$("div").animate({left:'+=200px'}, 2000);
$("div").animate({top:'0px'}, 600);
$("div").queue(function(){
$(this).toggleClass("red");
$(this).dequeue();
});
$("div").animate({left:'10px', top:'30px'}, 700);
});
});
</script>
</head>
<body>
<button>開始</button>
<div></div>
</body>
</html>
若在本機執行,記得存檔後按 F5 重新整理網頁才能看到效果。
點擊按鈕後,佇列裡依序排了四件事:向右移動、向上移動、切換顏色類別、回到原點。前三項都是標準動畫或會自動推進佇列的函式,但第四项是我們用 queue() 手動塞進去的 toggleClass。
關鍵就在最後那行 $(this).dequeue():toggleClass 執行完之後,它主動把佇列前端的那一段 animate(回到 left:10px、top:30px)取出並啟動。如果拿掉這行,方塊會在變色之後就停住,最後那段回位動畫永遠不會發生。
把兩者想成一條輸送帶就好:queue() 負責把東西放上去,dequeue() 負責讓輸送帶繼續轉。jQuery 對內建的動畫函式會自動處理推進,但對你手動加入的函式則不會——這正是為什麼自訂佇列函式結尾總得補上一句 dequeue()。