jQuery.extend() 是寫外掛時幾乎一定會用到的方法。它有幾種不同的呼叫形式,搞混了就容易出現「屬性莫名消失」或「原物件被改掉」的狀況。
只傳一個物件時,該物件的所有屬性與方法會被逐一複製到 jQuery 上,等於替 jQuery 掛新方法:
$.extend({
test: function () { alert('test 函數'); }
});
以 $.extend(css1, css2) 為例:css2 有而 css1 沒有的屬性會被補進 css1;若名稱重複,則css2 的值會覆蓋 css1。合併後的結果寫回 css1,也就是說 css1 本身會被改動。
var Css1 = { size: "10px", style: "oblique" };
var Css2 = { size: "12px", style: "oblique", weight: "bolder" };
$.extend(Css1, Css2);
// Css1 = { size: "12px", style: "oblique", weight: "bolder" }
如果不希望動到原本的物件,有兩個做法:
var newcss = $.extend({}, Css1, Css2); // 以空物件為目標,Css1 結構保持完整
把 {} 放在第一個參數的位置,是一個很值得養成習慣的寫法。
第一個參數傳入布林值時,代表要不要做「深層複製」。差別在巢狀物件上:
// 淺層合併
$.extend(
{ name: "John", location: { city: "Boston" } },
{ last: "Resig", location: { state: "MA" } }
);
// => { name: "John", last: "Resig", location: { state: "MA" } }
// 深層合併
$.extend(true,
{ name: "John", location: { city: "Boston" } },
{ last: "Resig", location: { state: "MA" } }
);
// => { name: "John", last: "Resig",
// location: { city: "Boston", state: "MA" } }
淺層合併時,後者的 location 直接取代前者,city 就丟了;加上 true 之後,兩個 location 的內容會被逐層合併。若 dest 與 src 有同名的巢狀屬性,extend 會對該屬性再遞迴複製一次。
jQuery.extend = jQuery.fn.extend = function () {
var target = arguments[0] || {}, i = 1,
length = arguments.length, deep = false, options;
// 處理深層複製的情況
if (target.constructor == Boolean) {
deep = target;
target = arguments[1] || {};
i = 2; // 跳過布林值與目標物件
}
// 目標不是物件或函式時,改用空物件
if (typeof target != "object" && typeof target != "function")
target = {};
// 只傳一個參數時,擴充 jQuery 本身
if (length == i) {
target = this;
--i;
}
for (; i < length; i++)
if ((options = arguments[i]) != null)
for (var name in options) {
var src = target[name], copy = options[name];
if (target === copy) continue; // 避免無窮迴圈
if (deep && copy && typeof copy == "object" && !copy.nodeType)
target[name] = jQuery.extend(deep,
src || (copy.length != null ? [] : {}), copy);
else if (copy !== undefined)
target[name] = copy; // undefined 不會被帶入
}
return target;
};
注意開頭那行:jQuery.extend = jQuery.fn.extend。前面已經把 jQuery.prototype 指派給 jQuery.fn,所以兩者其實是同一個函式,但呼叫方式決定了 this 指向誰:
jQuery.extend():this 是 jQuery 本身,方法被掛成靜態方法,需透過 jQuery.xxx() 呼叫。jQuery.fn.extend():this 是 jQuery 的原型,方法被掛到所有實例上,於 $() 產生的物件都能直接 .xxx() 使用。寫外掛時若希望 $('#el').myPlugin() 這種形式可用,就得用 $.fn.extend();若是 $.myUtil() 這種工具函式,則用 $.extend()。jQuery 原始碼裡到處都是這個區別的體現。