作者:nuysoft/高雲。邊讀邊寫,若有錯誤歡迎指正交流。
寫在前面:想系統地把 jQuery 寫清楚,但先從自己最有興趣的部分下手。後來有讀者把整理好的 PDF 傳到百度文庫並設了高額財富值才能下載,這並非原意,之後整理完成會自行發布,感謝大家體諒。
(function (window, undefined) {
var jQuery = (function () {
// 構建 jQuery 物件
var jQuery = function (selector, context) {
return new jQuery.fn.init(selector, context, rootjQuery);
};
// jQuery 物件原型
jQuery.fn = jQuery.prototype = {
constructor: jQuery,
init: function (selector, context, rootjQuery) {
// selector 有以下 7 種分支情況:
// DOM 元素 / body(優化) / 字串:HTML 標籤、HTML 字串、#id、選擇器表達式
// 函數(作為 ready 回呼) / 最後回傳偽陣列
}
};
// 讓 init 函數擁有 jQuery 原型,供之後的實例化使用
jQuery.fn.init.prototype = jQuery.fn;
// 合併內容到第一個參數,後續大部分功能都靠它擴充
jQuery.extend = jQuery.fn.extend = function () {};
// 在 jQuery 上擴充靜態方法
jQuery.extend({
// ready bindReady / isPlainObject isEmptyObject / parseJSON parseXML
// globalEval / each makeArray inArray merge grep map / proxy / access
// uaMatch / sub / browser
});
return jQuery;
})();
window.jQuery = window.$ = jQuery;
})(window);
一、jQuery 物件並不是用 new jQuery 產生的,而是 new jQuery.fn.init。
var jQuery = function (selector, context) {
return new jQuery.fn.init(selector, context, rootjQuery);
}
因此執行 new jQuery() 產生的物件會被丟掉,最後回傳的是 init 物件——這也解釋了為何呼叫時不需要 new。
二、原型鏈的指向順序。先執行 jQuery.fn = jQuery.prototype,再執行 jQuery.fn.init.prototype = jQuery.fn,合併後即:
jQuery.fn.init.prototype = jQuery.fn = jQuery.prototype;
掛到 jQuery.fn 上的方法,最終都相當於掛在 jQuery.fn.init.prototype 上,也就是掛在我們實際使用的 jQuery 物件上。這段繞來繞去的設計,是 jQuery 早期為了兼顧「$ 既是函數又有原型方法」而留下的結果。
init 的工作是分析傳進來的 selector,再走不同處理路徑:
document.createElement。document.createDocumentFragment。document.getElementById。$(...).find,也就是 Sizzle。這個函數是 jQuery 擴充能力的核心,註解寫得很清楚:
// 合併兩個或多個物件的屬性到第一個物件中
// 只傳一個物件時,屬性會被加到 jQuery 物件本身,這是寫插件的方式
// 不想改動傳入物件時,傳入空物件:$.extend({}, object1, object2)
// 預設為淺合併,嵌套物件會被整個覆蓋;第一個參數為 true 則遞迴合併
// undefined 值不會被複製;從原型繼承的屬性會被複製
// 因為效能原因,JavaScript 自帶類型的屬性不會被合併
jQuery.extend = jQuery.fn.extend = function () {
var options, name, src, copy, copyIsArray, clone,
target = arguments[0] || {},
i = 1,
length = arguments.length,
deep = false;
// 第一個參數是 boolean,代表深度拷貝
if (typeof target === "boolean") {
deep = target;
target = arguments[1] || {};
i = 2; // 跳過 boolean 與 target
}
// target 不是物件也不是函數,強制設為空物件
if (typeof target !== "object" && !jQuery.isFunction(target)) {
target = {};
}
// 只傳一個參數時,視為對 jQuery 擴充
if (length === i) {
target = this;
--i;
}
for (; i < length; i++) {
if ((options = arguments[i]) != null) { // 只處理非空參數
for (name in options) {
src = target[name];
copy = options[name];
if (target === copy) { continue; } // 避免循環引用
// 深度拷貝且值為純物件或陣列時遞迴
if (deep && copy && (jQuery.isPlainObject(copy) ||
(copyIsArray = jQuery.isArray(copy)))) {
if (copyIsArray) {
copyIsArray = false;
clone = src && jQuery.isArray(src) ? src : [];
} else {
clone = src && jQuery.isPlainObject(src) ? src : {};
}
target[name] = jQuery.extend(deep, clone, copy);
} else if (copy !== undefined) { // 不複製 undefined
target[name] = copy;
}
}
}
}
return target;
};
讀懂這段,等於掌握了 jQuery 大半的擴充邏輯——$.fn.extend 之所以能與 $.extend 共用同一份實作,關鍵就在最後那句「只傳一個參數時把 target 設為 this」:以 jQuery.extend 呼叫時 this 是 jQuery,以 jQuery.fn.extend 呼叫時 this 就是 jQuery.fn。