作者:nuysoft/高雲。本文為原創,轉載請保留出處。讀讀寫寫,錯誤之處歡迎指正。
系列目錄可見作者部落格。目前仍從個人感興趣的模組切入,若大家有特別想優先分析的區塊,歡迎建議。
noConflict: function (deep) {
if (window.$ === jQuery) { window.$ = _$; } // 交出 $
if (deep && window.jQuery === jQuery) { window.jQuery = _jQuery; } // 連 jQuery 一起交出
return jQuery;
}
$ 只是 jQuery 的別名,傳入 true 才會連 jQuery 名稱一起讓出。
相關狀態與方法:isReady(是否已就緒)、readyWait(等待計數器,初始為 1)、holdReady(繼續等待或放行)、ready(真正執行就緒流程)、bindReady(綁定事件)。
ready: function (wait) {
if ((wait === true && !--jQuery.readyWait) || (wait !== true && !jQuery.isReady)) {
if (!document.body) { return setTimeout(jQuery.ready, 1); } // 確保 body 存在
jQuery.isReady = true;
if (wait !== true && --jQuery.readyWait > 0) { return; }
readyList.resolveWith(document, [jQuery]);
if (jQuery.fn.trigger) {
jQuery(document).trigger("ready").unbind("ready");
}
}
}
bindReady 的相容處理很值得學:先檢測 document.readyState === "complete"(腳本晚到就熟的情況),接著用 功能檢測而非瀏覽器嗅探——有 addEventListener 就綁 DOMContentLoaded 並以 window.load 保底;否則走 IE 的 attachEvent("onreadystatechange"),並透過 window.frameElement == null 判斷是否在 iframe 中,決定要不要啟用 doScroll 輪詢。
isFunction: function (obj) { return jQuery.type(obj) === "function"; }
// 有原生 Array.isArray 就用,否則退回 type 判斷
isArray: Array.isArray || function (obj) { return jQuery.type(obj) === "array"; };
// 判斷 window:簡單地檢查 setInterval 屬性是否存在
isWindow: function (obj) { return obj && typeof obj === "object" && "setInterval" in obj; };
// 取得物件類型:借 Object.prototype.toString 得到 "[object Xxx]"
type: function (obj) {
return obj == null ? String(obj) : class2type[toString.call(obj)] || "object";
}
排除條件有兩層:obj 不存在、型別不是 object、是 DOM 節點或 window,一律 false;接著檢查 constructor 必須是自身屬性而非繼承而來(IE8 下會拋非法指標異常,所以要多這道檢查);最後遍歷屬性,若最後一個鍵是自身的,就認為全部都是自身的。
// $.isPlainObject({}) true
// $.isPlainObject(document) false
// $.isPlainObject(new Date()) false
parseJSON 先去除首尾空白(IE 無法處理),然後優先使用原生 window.JSON.parse——因為原生實作是 JS 引擎中的 Native Code,效率遠勝 eval。只有在不支援原生 API 的環境,才會用字元白名單檢查字串合法性後,退回 new Function("return " + data)()。
parseXML 同樣是標準與 IE 的封裝:有 window.DOMParser 就用它,否則建立 ActiveXObject("Microsoft.XMLDOM");最後檢查 documentElement 是否為 parsererror,是則拋錯。
globalEval: function (data) {
if (data && rnotwhite.test(data)) {
(window.execScript || function (data) {
window["eval"].call(window, data);
})(data);
}
}
IE 用 window.execScript,其他瀏覽器用 eval 並把 this 指向 window。之所以需要它,是因為整份 jQuery 都被包在一個匿名函數裡,當前 context 是 jQuery 而非 window。
each: function (object, callback, args) {
var name, i = 0,
length = object.length,
isObj = length === undefined || jQuery.isFunction(object);
if (args) { // 有 args 用 apply,上下文設為目前元素
if (isObj) {
for (name in object) {
if (callback.apply(object[name], args) === false) { break; }
}
} else {
for (; i < length;) {
if (callback.apply(object[i++], args) === false) { break; }
}
}
} else { // 無 args 用 call,參數為 (index, value)
if (isObj) {
for (name in object) {
if (callback.call(object[name], name, object[name]) === false) { break; }
}
} else {
for (; i < length;) {
if (callback.call(object[i], i, object[i++]) === false) { break; }
}
}
}
return object;
}
兩個細節:回傳 false 可中斷迴圈;回傳物件本身以維持鏈式呼叫。
trim 盡量用原生 String.prototype.trim,沒有時才用兩端正則替換。
makeArray 把偽陣列轉成真陣列,其中針對 window、字串、函數、正則等「有 length 但不是陣列」的情況逐一判斷,註解裡滿是各瀏覽器的相容測試紀錄(Safari 2、BlackBerry 4.7 等)。
inArray 有原生 indexOf 就用,否則手寫迴圈;順帶的技巧是把 array.length 存進區域變數,減少一次作用域查找。
merge 把 second 併入 first,會依 second 是否有 number 型別的 length 決定用索引迴圈還是 while 遍歷,最後修正 first 的 length。
grep 過濾陣列,callback 回傳 true 時保留;inv 為 true 則反轉條件。
map 是「映射」,會先判斷傳入的是陣列還是物件(jQuery 物件也當陣列處理),分別用不同方式遍歷,把不為 null 的結果收集起來,最後用 ret.concat.apply([], ret) 把嵌套陣列攤平。
proxy: function (fn, context) {
if (typeof context === "string") { // 支援 $.proxy(obj, "method") 寫法
var tmp = fn[context];
context = fn;
fn = tmp;
}
if (!jQuery.isFunction(fn)) { return undefined; }
var args = slice.call(arguments, 2),
proxy = function () {
return fn.apply(context, args.concat(slice.call(arguments)));
};
proxy.guid = fn.guid = fn.guid || proxy.guid || jQuery.guid++; // 統一 guid 才能被移除
return proxy;
}
最後那行 guid 同步很關鍵:事件處理器是靠 guid 對應來解除綁定的,若不統一,proxy 包裝過的函數就永遠移不掉。
css、attr、prop 三個方法底層都呼叫它。key 是物件時迭代設定多個屬性;value 不為 undefined 時走設定分支(若 exec 為 true 且 value 是函數,會先執行再取值);否則走讀取分支,只取第一個元素。
uaMatch 依序用正則匹配 webkit、opera、msie,最後才在不含 "compatible" 時嘗試 mozilla,回傳 { browser, version }。
sub 建立一個 jQuery 副本,可覆寫方法而不影響原型;但作者特別註明它並不提供真正的隔離,所有屬性方法仍指向原始 jQuery,若要用它寫插件,建議改用 jQuery UI 的 widget 工程。
最後是 browser:官方明確不鼓勵嗅探瀏覽器,應該改用功能檢測的 jQuery.support,未來甚至可能把 browser 移到外掛中。
讀完這一組工具函數,你會發現 jQuery 大量使用了幾個固定套路:借雞生蛋(借用 slice、push)、功能檢測優先於瀏覽器嗅探、原生 API 優先於手寫實作。這三點即使放在今天的專案中,依然是值得遵守的原則。