「插件」這個詞很多人並不陌生,有人叫它「組件」或「部件」,名稱不重要,關鍵是怎麼設計、怎麼做全方位取捨。這系列文章就以廣為人知的「jQuery 插件方式」作為切入點,一路討論到脫離 jQuery 的重構方案。

一般來說,jQuery 插件開發分為兩種:掛在 jQuery 命名空間下的全域函式(靜態方法),以及掛在 jQuery 原型上的物件層級方法——後者能讓所有透過選擇器取得的 jQuery 實例共享。
最直接的理解就是給 jQuery 這個「類」添加類方法,典型的例子是 $.ajax()。
1.1 添加單一全域函式
$.hello = function () {
alert("Hello,大熊君!");
};
1.2 一次添加多個全域函式
$.extend({
hello: function (name) {
// put your code here
},
world: function () {
// put your code here
}
});
$.extend(target, [object1], [objectN]) 主要用於把兩個或更多物件的屬性合併到第一個物件並回傳它。若只傳一個參數,該參數會直接擴展 jQuery 的命名空間,也就是作為靜態方法掛在全域物件下。
2.1 用 $.fn.extend() 掛載屬性
(function ($) {
$.fn.extend({
pluginName: function (opts) {
// put your code here
}
});
})(jQuery);
2.2 直接把屬性加進原型鏈
(function ($) {
$.fn.pluginName = function () {
// put your code here
};
})(jQuery);
兩者等價。對簡單插件來說,一個函式就足夠;但面對複雜一點的插件,需要提供各種方法與私有函式。你可能會用不同命名空間來組織這些方法,然而命名空間開太多反而讓程式碼混亂、健壯性下降。最好的解法是適度定義私有函式——也就是用「立即執行函式 + 閉包」模擬私有單元,如上例所示。
(1)HTML 片段
<div id="bb" style="width:220px;border:1px solid #ccc;">
<span></span>
<div style="margin-top:10px;margin-bottom:30px;">8</div>
</div>
(2)data.json
{
"text": "你好,大熊君{{bb}} !"
}
(3)bb.js
$(function () {
$("#bb").bigbear();
});
(function ($) {
$.fn.bigbear = function (opts) {
opts = $.extend({}, $.fn.bigbear.defaults, opts);
return this.each(function () {
var elem = $(this);
elem.find("span").text(opts["title"]);
$.get(opts["url"], function (data) {
elem.find("div").text(data["text"]);
});
});
};
$.fn.bigbear.defaults = {
title: "這是一個簡單的測試",
url: "data.json"
};
})(jQuery);
執行後,span 顯示標題,div 顯示由 data.json 非同步取回的內容。

$.fn.pluginName.defaults 搭配 extend,讓使用者依需求自訂選項並控制插件行為。擴充性良好的插件一定保留恢復預設值的能力。官方提供的兩個擴充入口是 jQuery.fn.extend(object)(給 jQuery 實例添加方法)與 jQuery.extend(object)(擴展 jQuery 類本身,添加靜態方法),選哪一個取決於你的 API 要服務「元素集合」還是「全域工具」。
如果專案的技術選型換掉,而這些插件又強依賴 jQuery 機制,我們過去寫的插件就全部報廢了(假設不再使用 jQuery)。這時該怎麼重構?下一篇就來處理這個問題,並重新組織插件的關鍵邏輯。