DIV CSS 佈局教程網

jQuery 隊列控制詳解:queue()、dequeue() 與 clearQueue()
編輯:JQuery特效代碼     

要讓一串動畫依序播放,最直白的寫法是把回呼函式一層層往內嵌。七個元素就已經縮排到看不懂,更別說之後想調整順序。jQuery 的隊列方法就是為了解決這個問題。

三個方法的意義

queue(name, [callback])

只傳一個參數時,它回傳並指向第一個符合元素的隊列(一個函式陣列,隊列名稱預設是 fx)。傳兩個參數時,第一個仍是隊列名,第二個則分兩種情況:若為函式,就在隊列末尾追加一項;若為函式陣列,則用新隊列整體替換原本的。

dequeue(name)

從隊列最前端取出一個函式並執行它。顧名思義,就是「出隊」。

clearQueue([queueName])

1.4 版新增,用來清空尚未執行的隊列,參數可選、預設 fx。實際上這個方法不太必要——用 queue() 傳入空陣列即可達到相同效果,而且更直觀。

需求:讓七個方塊依序落下

先看看不用隊列的傳統寫法:

$('.one').delay(500).animate({top:'+=270px'},500,function(){
  $('.two').delay(500).animate({top:'+=270px'},500,function(){
    $('.three').delay(500).animate({top:'+=270px'},500,function(){
      $('.four').delay(500).animate({top:'+=270px'},500,function(){
        $('.five').delay(500).animate({top:'+=270px'},500,function(){
          $('.six').delay(500).animate({top:'+=270px'},500,function(){
            $('.seven').animate({top:'+=270px'},500,function(){
              alert('按序落體運動結束!Yeah!');
            });
          });
        });
      });
    });
  });
});

效果確實完美,但這團抵達尾端的縮排你能忍受嗎?更麻煩的是,如果之後想把順序改成「5 落下後再落 3」,或者新增 8 到 15 號方塊,你得在這團巢狀結構裡小心翼翼地改,出錯機率不低。

改用隊列

var _slideFun = [
    function(){ $('.one').delay(500).animate({top:'+=270px'},500,_takeOne); },
    function(){ $('.two').delay(300).animate({top:'+=270px'},500,_takeOne); },
    function(){ $('.three').delay(300).animate({top:'+=270px'},500,_takeOne); },
    function(){ $('.four').delay(300).animate({top:'+=270px'},500,_takeOne); },
    function(){ $('.five').delay(300).animate({top:'+=270px'},500,_takeOne); },
    function(){ $('.six').delay(300).animate({top:'+=270px'},500,_takeOne); },
    function(){
        $('.seven').delay(300).animate({top:'+=270px'},500,function(){
            alert('按序落體運動結束!Yeah!');
        });
    }
];

$('#demo').queue('slideList', _slideFun);

var _takeOne = function(){
    $('#demo').dequeue('slideList');
};

_takeOne();

步驟拆開來看:

  1. 建立一個陣列,把動畫函式依序放進去——要改順序或新增項目,直接動這個陣列就好。
  2. 用 queue() 把整組函式掛進名為 slideList 的自訂隊列。
  3. 用 dequeue() 取出並執行第一個函式。
  4. 手動呼叫一次 _takeOne() 作為啟動點。

之後每個動畫在回呼中呼叫 _takeOne,就會自動接續下一個,形成一條流暢的鏈。

為什麼自訂隊列名值得

這裡刻意用了 slideList 而非預設的 fx。原因是 fx 已被 jQuery 的動畫機制佔用,若混用,你的邏輯可能和 animate() 內建的隊列互相干擾。自訂名稱能把兩者徹底隔開,也讓程式碼的意圖更清楚。

至於停止功能,示範中呼叫的就是 clearQueue();如前所述,你也可以用 queue('slideList', []) 直接把隊列替換成空陣列,效果相同而語意更直白。

原文發表於 Mr.Think 的部落格:https://mrthink.net/jqueryapi-queue-dequeue/

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