DIV CSS 佈局教程網

jQuery queue() 方法詳解:控制動畫與自訂函式的執行順序
編輯:JQuery特效代碼     

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("動畫完成");
  });
});

這樣「動畫完成」就會老實地排在三段動畫之後,等前面全部跑完才寫進元素。

關鍵細節:記得 dequeue()

再看一個進階案例。若我們想在自訂函式之後再接一段動畫:

$(".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(),否則整條佇列會卡在那裡,後續的動畫與函式永遠等不到執行機會。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved