jQuery 提供兩個開發外掛的方法,名字只差三個字,行為卻完全不同。搞不清楚這兩者,寫出來的外掛會「怎麼呼叫都沒反應」。
jQuery.fn.extend(object); jQuery.extend(object);
簡單講:jQuery.extend(object) 是擴充 jQuery 類別本身,為類別加上新方法;jQuery.fn.extend(object) 則是為 jQuery 物件加上方法。
翻一下 jQuery 原始碼就會發現:
jQuery.fn = jQuery.prototype = {
init: function( selector, context ) { /* …… */ }
};
原來 jQuery.fn 就是 jQuery.prototype。對 prototype 應該不陌生吧?
雖然 JavaScript 沒有明確的 class 概念,但用類別來理解會方便很多。jQuery 就是一個封裝得很好的類別,當我們寫 $("#btn1") 時,其實是產生了一個 jQuery 類別的實例。理解了這點,兩個 extend 的差異就一目了然。
$.extend({
add: function(a, b){ return a + b; }
});
$.add(3, 4); // 回傳 7
這為 jQuery 類別加上一個名為 add 的「靜態方法」,在引入 jQuery 的地方都能直接呼叫,不需要先產生實例。$.ajax()、$.each() 這些你天天在用的都是這一類。
它對 jQuery.prototype 做擴充,也就是為 jQuery 類別添加「成員函式」,讓 jQuery 的實例可以呼叫。
舉個實際例子:做一個特殊的輸入框,被點擊時就跳出目前的內容。
$.fn.extend({
alertWhileClick: function(){
$(this).click(function(){
alert($(this).val());
});
}
});
$("#input1").alertWhileClick(); // 對應 <input id="input1" type="text"/>
$("#input1") 是一個 jQuery 實例,當它呼叫成員方法 alertWhileClick 後就完成了擴充,之後每次被點擊都會先跳出輸入框裡目前的內容。
jQuery 原始碼裡有這麼一行:jQuery.extend = jQuery.fn.extend,而前面已經把 jQuery.prototype 指派給 jQuery.fn 了。因此在後續程式碼中,jQuery.extend() 與 jQuery.fn.extend() 雖然是同一個函式,呼叫的 this 卻不同,產生的結果也就不同:
jQuery.extend() 不會把方法擴充到物件實例上,要引用必須透過 jQuery 類別本身(例如 jQuery.init());jQuery.fn.extend() 則把方法掛到 prototype 上,因此實例化時每個物件都具備這些方法。這個差異貫穿整個 jQuery 原始碼,值得細讀。
寫外掛時有個慣例值得遵守:把你的方法掛進 jQuery 自己的命名空間,而不是直接污染 $.fn 的頂層,例如 $.myPlugin = { ... } 搭配 $.fn.myPlugin,並在函式開頭包成 (function($){ ... })(jQuery) 以避免全域變數衝突。真实專案裡不會做這麼小白的插件,但觀念是相通的。