extend() 是 jQuery 的基礎函數之一,作用是擴展現有的物件。在撰寫外掛的過程中,extend 是我們最常用的方法之一,它透過幾種重載原型,實現了物件合併與命名空間擴展。本文將深入解析它的功能、源碼與使用技巧。
extend 主要具有以下幾種呼叫形式:
extend(dest, src1, src2, src3...);
var newSrc = $.extend({}, src1, src2, src3...);
extend(boolean, dest, src1, src2, src3...);
第一個原型會將 src1、src2……合併到 dest 中,回傳合併後的 dest。若不想修改 dest 的結構,可以把空物件 {} 作為 dest:
var result = $.extend({}, {name: "Tom", age: 21}, {name: "Jerry", sex: "Boy"});
// result = {name: "Jerry", age: 21, sex: "Boy"}
也就是說,若後面的參數與前面的參數存在相同名稱,後者會覆蓋前者。
第三個原型的第一個參數是布林值,代表是否進行深度拷貝:
var result = $.extend(true, {},
{ name: "John", location: {city: "Boston", county: "USA"} },
{ last: "Resig", location: {state: "MA", county: "China"} }
);
// 深度拷貝結果會合併嵌套子物件:
// result = {name: "John", last: "Resig", location: {city: "Boston", state: "MA", county: "China"}}
若第一個參數為 false,則嵌套子物件會被直接覆蓋,不會合併。
當省略 dest 時,該方法只能有一個 src 參數,並會將它合併到呼叫 extend 的物件中:
// 合併到 jQuery 全域物件
$.extend({ hello: function(){ alert('hello'); } });
// 合併到 jQuery 實例物件
$.fn.extend({ hello: function(){ alert('hello'); } });
jQuery.extend 的核心邏輯是:先判斷第一個參數是否為布林值(決定是否深度拷貝),再確定目標物件,然後遍歷每個來源物件的屬性。在深度拷貝時,若屬性是純物件或陣列,會遞迴呼叫自身進行合併;否則直接覆蓋(並忽略 undefined 值)。以下為簡化後的源碼:
jQuery.extend = jQuery.fn.extend = function() {
var options, name, src, copy, copyIsArray, clone,
target = arguments[0] || {},
i = 1,
length = arguments.length,
deep = false;
// 處理深度拷貝情況
if ( typeof target === "boolean" ) {
deep = target;
target = arguments[1] || {};
i = 2;
}
// 當目標物件型別錯誤時,重置為 {}
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 ) {
target[name] = copy;
}
}
}
}
return target;
};
// 在 jQuery 全域物件中擴展一個 net 命名空間
$.extend({net:{}});
// 將 hello 方法擴展到 net 命名空間中
$.extend($.net, {
hello: function(){ alert('hello'); }
});
透過 extend,我們能優雅地組織外掛程式碼、建立自訂命名空間,並靈活地合併設定物件,是撰寫 jQuery 外掛不可或缺的核心工具。