jQuery 的整體框架龐大且不易讀通,值得花時間反覆咀嚼。以下以 jquery-1.7.1 為例,從宏觀架構一路看到關鍵實作。
jQuery 的程式碼大致可分為三層:入口模組、底層模組、功能模組。開頭與結尾長得像這樣:
(function( window, undefined ) {
// 構造 jQuery 對象
var jQuery = (function() {
var jQuery = function( selector, context ) {
return new jQuery.fn.init( selector, context, rootjQuery );
};
jQuery.fn = jQuery.prototype = {
constructor: jQuery,
init: function( selector, context, rootjQuery ) { ... },
// 一堆原型屬性和方法
};
jQuery.fn.init.prototype = jQuery.fn;
jQuery.extend = jQuery.fn.extend = function() { ... };
jQuery.extend({
// 一堆靜態屬性和方法
});
return jQuery;
})();
// 省略其他模組 …
window.jQuery = window.$ = jQuery;
})( window );
骨架縮寫後其實很簡潔:
(function(window, undefined) {
var jQuery = function() {}
// ...
window.jQuery = window.$ = jQuery;
})(window);
採用「匿名函數自執行」的寫法,最大的好處是隔離作用域,避免污染全域命名空間。
JavaScript 變數沿作用域鏈查找,越靠近當前作用域越快。把 window 傳成參數後,它就變成函數內的區域變數,jQuery 內部存取 window 時不必一路回溯到最外層。
undefined 的用意類似,但更微妙:它是 window 的屬性,而且可以被重新賦值。宣告這個參數卻不傳值,等於在自執行函數的作用域內確保 undefined 真的是「未定義」,同時也縮短了查找路徑。
jQuery.fn = jQuery.prototype = {
constructor: jQuery,
init: function( selector, context, rootjQuery ) { ... },
};
寫法很直白:jQuery.fn 就是 jQuery.prototype,只是少打幾個字。再加上 $ 這個簡寫,就有了我們每天在寫的 $()。
值得注意的是,jQuery 物件並不是用 new jQuery 產生的:
var jQuery = function( selector, context ) {
return new jQuery.fn.init( selector, context, rootjQuery );
}
真正做事的是 jQuery.fn.init。它是原型方法,同時扮演構造函數的角色,負責解析 selector 與 context 的型別並執行對應的查找。接著這一行把兩者的原型接通:
jQuery.fn.init.prototype = jQuery.fn = jQuery.prototype
於是 new jQuery.fn.init(...) 產生的物件,也具備了 jQuery.fn 上的所有方法——鏈式呼叫因此成立。
預設情況下,查找從 document 開始,範圍是整个文件樹。但你可以傳入第二個參數縮小範圍:
$('div.foo').click(function () {
$('span', this).addClass('bar'); // 只在這個 div 內找 span
});
而 rootjQuery 則是包含 document 的 jQuery 物件,作為 getElementById 等查找失敗時的後路。
jQuery.extend = jQuery.fn.extend = function() {
var options, name, src, copy, copyIsArray, clone,
target = arguments[0] || {},
i = 1,
length = arguments.length,
deep = false;
...
};
jQuery.extend(object) 為 jQuery 類別添加靜態方法:
$.extend({
add: function(a, b){ return a + b; }
});
$.add(3, 4); // 7
jQuery.fn.extend(object) 則擴充原型,讓所有 jQuery 物件都能使用:
jQuery.fn.extend({
check: function() {
return this.each(function() { this.checked = true; });
},
uncheck: function() {
return this.each(function() { this.checked = false; });
}
});
$( "input[type='checkbox']" ).check();
jQuery 之所以強大,Sizzle 功不可沒。以這個選擇器為例:
selector: 'div > p + div.aaron input[type="checkbox"]'
解析大致依下列步驟進行:
[type="checkbox"],得到類似 { matches: [...], type: "ATTR", value: '[type="' } 的結構。>、+、~ 或空白這四種關係選擇器之一,跳過並繼續往前。耗時操作往往需要回呼,而 jQuery 早期在這塊偏弱,deferred 就是為此而生。ajax 因此得以改寫成鏈式:
$.ajax({
url: "test.html",
success: function(){ alert("哈哈,成功了!"); },
error: function(){ alert("出錯啦!"); }
});
// 1.5.0 之後可以寫成
$.ajax("test.html")
.done(function(){ alert("哈哈,成功了!"); })
.fail(function(){ alert("出錯啦!"); });
更實用的是為多個任務掛同一組回呼:
$.when($.ajax("test1.html"), $.ajax("test2.html"))
.done(function(){ alert("哈哈,成功了!"); })
.fail(function(){ alert("出錯啦!"); });
兩個都成功才觸發 done,任一失敗即觸發 fail。
它 internally 維護三個回呼列表——成功、失敗、通知——其他方法都圍繞這三個列表運作:
jQuery.extend({
Deferred: function( func ) {
// 成功回呼函數列表
var doneList = jQuery.Callbacks( "once memory" ),
// 失敗回呼函數列表
failList = jQuery.Callbacks( "once memory" ),
// 通知回呼函數列表
progressList = jQuery.Callbacks( "memory" ),
// 初始狀態
state = "pending",
// 異步隊列的只讀副本
promise = { /* done, fail, progress, state, then, always, pipe, promise ... */ },
deferred = promise.promise({}),
key;
// 掛上觸發回呼的方法
for ( key in lists ) {
deferred[ key ] = lists[ key ].fire;
deferred[ key + "With" ] = lists[ key ].fireWith;
}
// 狀態轉移
deferred.done( function() {
state = "resolved";
}, failList.disable, progressList.lock )
.fail( function() {
state = "rejected";
}, doneList.disable, progressList.lock );
if ( func ) {
func.call( deferred, deferred );
}
return deferred;
},
});
"once memory" 的意義是:回呼只執行一次,且已觸發的事件會記住參數,後加入的回呼仍能被立即呼叫——這正是 deferred 好用的關鍵。
傳入多個異步隊列時,jQuery.when() 回傳一個主隊列的唯讀副本,用來追蹤所有傳入對象的最終狀態:全部成功則觸發主隊列的成功回呼,任一失敗則觸發失敗回呼。
var whenDone = function(){ console.log('done', arguments); },
whenFail = function(){ console.log('fail', arguments); };
$.when(
$.ajax('/when.do?method=when1', { dataType: "json" }),
$.ajax('/when.do?method=when2', { dataType: "json" }),
$.ajax('/when.do?method=when3', { dataType: "json" })
).done(whenDone).fail(whenFail);
jQuery.fn = jQuery.prototype = {
constructor: jQuery,
init: function( selector, context, rootjQuery ) {},
selector: "",
jquery: "1.7.1",
length: 0,
size: function() {},
toArray: function() {},
get: function( num ) {},
pushStack: function( elems, name, selector ) {},
each: function( callback, args ) {},
ready: function( fn ) {},
eq: function( i ) {},
first: function() {},
last: function() {},
slice: function() {},
map: function( callback ) {},
end: function() {},
push: push,
sort: [].sort,
splice: [].splice
};
幾個值得注意的細節:
selector 記錄查找與篩選時使用的選擇器表達式。length 代表目前集合中的元素個數。size() 功能等同 length,但因為有函數呼叫開銷,應優先使用屬性。size: function(){
return this.length;
}
get() 的實作藏了一個小技巧——支援負數索引:
get: function( num ) {
return num == null ?
this.toArray() :
( num < 0 ? this[ this.length + num ] : this[ num ] );
}
each() 內部其實只是轉呼叫靜態版本:
each: function( callback, args ) {
return jQuery.each( this, callback, args );
}
回呼以目前元素為 this 上下文,回傳 false 即可中斷遍歷。map() 則會把回呼的返回值收進新的 jQuery 物件:
map: function( callback ) {
return this.pushStack( jQuery.map(this, function( elem, i ) {
return callback.call( elem, i, elem );
}));
}
pushStack() 建立新的空 jQuery 物件、放入元素集合,並保留對目前物件的引用。以下方法都靠它運作:
eq()、first()、last()、slice()、map()find()、not()、filter()、closest()、add()、andSelf()parent()、parents()、next()、prev()、nextAll()、siblings()、children()、contents() 等相對地,end() 負責出棧:
end: function() {
return this.prevObject || this.constructor(null);
}
若不存在前一個物件,就回傳一個空的 jQuery 物件。
jQuery.extend({...}) 掛载了大量工具型方法,包括型別判斷(isFunction、isArray、isWindow、isPlainObject、isEmptyObject)、資料處理(each、map、grep、merge、makeArray、inArray)、ready 流程(isReady、readyWait、holdReady、bindReady)與其他輔助(trim、proxy、camelCase、parseJSON、parseXML)等。
讀源碼最大的收穫不是記住某個實作細節,而是理解 jQuery 為什麼能同時保持簡潔 API 與強大能力:匿名閉包隔離、原型鏈打通、extend 分流靜態與實例方法、Sizzle 負責選擇器、deferred 負責非同步。這幾個設計決定,撐起了整個框架。
篇幅關係先寫到這裡,其餘模組有機會再補。