寫 jQuery 外掛時,extend() 幾乎是必用工具。它有好幾個重載形式,行為差異不小,搞不清楚很容易把全域物件污染得一塌糊塗。
extend(dest, src1, src2, src3 ...);
把 src1、src2……合併進 dest 並回傳 dest。注意:dest 的結構會被直接修改。若不想動到 dest,就傳一個空物件當第一個參數:
var newSrc = $.extend({}, src1, src2, src3 ...);
例如:
var result = $.extend({}, { name: "Tom", age: 21 }, { name: "Jerry", sex: "Boy" });
// result = { name: "Jerry", age: 21, sex: "Boy" }
規則很直白:後面的參數若與前面同名,會覆蓋前面的值。
dest 可以省略,此時只能有一個 src,並且會被合併到「呼叫 extend 的那個物件」上。
1. $.extend(src) — 掛到 jQuery 全域物件
$.extend({ hello: function () { alert('hello'); } });
// 之後可直接 $.hello()
2. $.fn.extend(src) — 掛到 jQuery 實例物件
$.fn.extend({ hello: function () { alert('hello'); } });
// 之後可 $('#el').hello()
實務上常見的命名空間技巧:
$.extend({ net: {} }); // 建立 net 命名空間
$.extend($.net, { hello: function () { alert('hello'); } }); // 往命名空間掛方法
extend(boolean, dest, src1, src2, src3 ...);
第一個參數代表是否進行深度合併。
var result = $.extend(true, {},
{ name: "John", location: { city: "Boston", county: "USA" } },
{ last: "Resig", location: { state: "MA", county: "China" } });
// 深拷貝(true):location 的屬性被逐層合併
// result = { name:"John", last:"Resig",
// location: { city:"Boston", state:"MA", county:"China" } }
var result = $.extend(false, {},
{ name: "John", location: { city: "Boston", county: "USA" } },
{ last: "Resig", location: { state: "MA", county: "China" } });
// 淺合併(false):location 被整個替換
// result = { name:"John", last:"Resig",
// location: { state:"MA", county:"China" } }
差別就在嵌套物件是被「逐層合併」還是「整體覆蓋」,設定外掛預設值時,通常用深拷貝比較安全。
1. 封裝物件方法:針對由選擇器取得的 jQuery 物件操作,最常見的一種。parent()、appendTo() 都屬於這類,用 $.fn.extend() 擴充。
2. 封裝全域函式:把獨立函式掛到 jQuery 命名空間下,例如 jQuery.ajax()、jQuery.trim(),用 $.extend() 擴充。
3. 選擇器外掛:擴充自訂選擇器,同樣透過 $.extend()。
兩個方法都只接受一個 Object 參數,物件的「名/值對」分別代表「函式名/函式主體」。
// 擴充 jQuery 靜態方法
$.extend({ test: function () { alert('test 函式'); } });
// 呼叫:$.test()
// 合併多個物件,同名屬性由後者覆蓋
var Css1 = { size: "10px", style: "oblique" };
var Css2 = { size: "20px", style: "oblique", weight: "bolder" };
$.extend(Css1, Css2);
// Css1 = { size:"20px", style:"oblique", weight:"bolder" }
// 保留原物件結構
var newCss = $.extend({}, Css1, Css2);
一句心法:$.fn.extend() 給「元素可操作的方法」,$.extend() 給「工具函式與靜態方法」,需要巢狀合併時記得開 true。