jQuery 的 .animate().animate().animate() 之所以能依序播放,靠的是內部的隊列(queue)機制。本文拆解一份教學用的精簡實作,看它如何用一個陣列加上「動畫鎖」,重現同樣的效果。
這份程式碼模仿 jQuery 的模組寫法,用立即執行函式把建構函式注入全域:
(function ($) {
window.$ = $;
})(function () {
// 這個函式的回傳值就是 $
return aQuery;
}());
這種「立即執行函式表達式」(IIFE)的寫法有兩個目的:一是建立獨立作用域,內部變數不會污染全域;二是透過參數傳入依賴,避免名稱衝突。jQuery 原始碼本身就是這個架構。
// 用來匹配 ID 字串((?: 表示此處不建立群組)
var rquickExpr = /^(?:#([\w-]*))$/;
function aQuery(selector) {
return new aQuery.fn.init(selector);
}
正則表達式只處理最簡單的 #id 形式,把井號後的字串擷取出來。aQuery() 呼叫時會建立一個 init 實例,這個「建構函式指標指向 init」的設計正是 jQuery 讓 $() 能不用 new 也能運作的手法。
var animation = function () {
var self = {};
var Queue = []; // 動畫隊列
var fireing = false; // 動畫鎖
var first = true; // 是否由 add 介面首次觸發
var getStyle = function (obj, attr) {
return obj.currentStyle ? obj.currentStyle[attr]
: getComputedStyle(obj, false)[attr];
};
// 具體的動畫效果
var makeAnim = function (element, options, func) {
var width = options.width;
element.style.webkitTransitionDuration = '2000ms';
element.style.webkitTransform = 'translate3d(' + width + 'px,0,0)';
// 監聽動畫結束
element.addEventListener('webkitTransitionEnd', function () {
func();
});
};
var _fire = function () {
if (!fireing) { // 沒有動畫正在跑
var onceRun = Queue.shift(); // 取出隊列中的第一個
if (onceRun) {
fireing = true; // 上鎖,防止重複觸發
onceRun(function () { // 執行它,並傳入「下一步」的函式
fireing = false; // 解鎖
_fire(); // 遞迴處理下一個
});
} else {
fireing = true;
}
}
};
return self = {
add: function (element, options) {
// 關鍵:往陣列裡放的不是資料,而是一個函式
Queue.push(function (func) {
makeAnim(element, options, func);
});
if (first && Queue.length) {
first = false; // 此開關讓後續加入的元素乖乖排隊
self.fire();
}
},
fire: function () {
_fire();
}
};
}();
整個設計最巧妙的一點在 add():它推進隊列的不是元素或參數,而是一個「接受回呼的函式」。
Queue.push(function (func) {
makeAnim(element, options, func);
});
於是當 _fire() 用 Queue.shift() 取出 onceRun 並呼叫 onceRun(callback) 時,那個 callback 就被傳進 makeAnim,成為動畫結束後要呼叫的 func。而這個 func 做的事是「解鎖並再次呼叫 _fire()」,於是下一個動畫自然接續——串接效果就這樣誕生了。
fireing 這個旗標扮演的是「動畫鎖」:只要有不會重複取出下一個任務,避免同一時間有多個動畫並行。first 旗標則確保只有第一次呼叫 add 時會啟動播放,之後新增的動畫一律排到隊尾,這正是 jQuery 的行為。
aQuery.fn = aQuery.prototype = {
run: function (options) {
animation.add(this.element, options);
return this; // 回傳自己,串接才得以成立
}
};
var init = aQuery.fn.init = function (selector) {
var match = rquickExpr.exec(selector);
var element = document.getElementById(match[1]);
this.element = element;
return this;
};
init.prototype = aQuery.fn;
return aQuery;
這裡有兩個值得注意的細節。第一,run() 回傳 this,這正是鏈式呼叫的基礎——每個方法都回傳 jQuery 物件本身,下一個方法才能接上去。
第二,作者刻意把 init 另外存成一個變數,而不是直接寫 aQuery.fn.init = aQuery.fn。這樣做能減少一次屬性查詢,是很典型的效能微調手法。
// HTML
// <div id="div1" style="width:100px;height:50px;background:red;
// cursor:pointer;color:#fff;text-align:center;line-height:50px;">點擊</div>
var oDiv = document.getElementById('div1');
oDiv.onclick = function () {
$('#div1').run({ 'width': '500' })
.run({ 'width': '300' })
.run({ 'width': '1000' });
};
三個 run 連續呼叫,元素會依序經歷 500 → 300 → 1000 的位移,完全不會同時發生。
值得學的是三件事:用 IIFE 建立私有作用域、用「函式陣列」實作任務隊列、以及用回傳 this 支援鏈式呼叫。這三者是閱讀 jQuery 原始碼時反覆出現的模式。
當然,作為教學範例它有明顯限制:只實作 #id 選擇器、動畫只用 -webkit- 前綴(因此範例特別提醒要用 Chrome 開啟)、也没有 duration、easing 等參數。若要應用在真實專案,動畫部分建議直接用 CSS transition 搭配 classList 切換,或使用 Web Animations API,把逐幀計算交給瀏覽器,效能與相容性都更好;隊列的觀念則可以保留,作為理解「如何讓一連串非同步任務依序執行」的入門。