要寫外掛,得先分清楚 jQuery 提供的兩個擴充方法。它們名字只差三個字,用途卻完全不同,搞混的結果就是「方法掛上去卻叫不動」。
jQuery.extend():建立全域函式或選擇器,呼叫方式是 jQuery.xxx()。jQuery.fn.extend():建立 jQuery 物件方法,呼叫方式是 $('selector').xxx()。jQuery.fn 其實就是 jQuery.prototype 的別名,寫起來比較短。兩者都只接受一個參數,且該參數必須是「名稱/值」結構的物件:名稱是函式或方法名,值就是函式主體。
jQuery.extend({
minValue : function(a, b){
return a > b ? b : a;
},
maxValue : function(a, b){
return a < b ? b : a;
},
})
呼叫時必須從 jQuery 本身著手:
<script>
$(function(){
$('input').click(function(){
var a = prompt("請輸入一個值");
var b = prompt("請輸入一個值");
var c = jQuery.minValue(a, b);
var d = jQuery.maxValue(a, b);
alert("你輸入的最小值:" + c + "\n你輸入的最大值:" + d);
});
});
</script>
<input type="button" value="jQuery 外掛測試" />
注意 prompt 回傳的是字串,直接比較會得到字典序的結果(例如 "10" < "9")。實戰時記得先 parseFloat 或 parseInt 轉型。
jQuery.extend() 除了建立全域函式,最常被拿來用的其實是「合併物件」。這也是外掛接受參數的標準做法:
function fn(options){
var options = jQuery.extend({ name1: value1, name2: value2, name3: value3 }, options);
// 函式主體
}
它的行為是:以第一個物件為基礎,用第二個物件的屬性覆蓋同名的部分。於是:
fn({ name1: value2, name2: jine, name3: hx }); // 全部覆蓋成新值
fn({ name4: value2, name5: jine }); // 新增選項
fn(); // 全部沿用預設值
三種呼叫都合法,這正是「合理預設 + 彈性覆寫」的標準模式。後面幾節會看到,把 defaults 獨立成 $.fn.pluginname.defaults 之後,使用者甚至不必每次傳參,直接改預設物件即可。
未完待續。