jQuery 是繼 Prototype 之後廣受歡迎的 JavaScript 函式庫。它以輕量著稱,相容 CSS 選擇器與主流瀏覽器,讓 DOM 操作、事件綁定、動畫與 AJAX 都變得直觀;文件完整、生態成熟,更是它能長紅的關鍵。其中「外掛機制」讓社群得以大量擴充功能,但也因為寫法門檻低,網路上素質良莠不齊的外掛相當多。以下整理撰寫外掛時該守住的基本規範。

針對選到的元素做操作的「物件級」外掛,用 jQuery.fn.extend() 擴充;提供工具函式、不綁定在元素集合上的「類級」外掛,用 jQuery.extend()。兩者對應的掛載位置不同,用錯就會找不到方法。
遵循 jquery.[外掛名].js 的命名慣例,例如 jquery.newplugin.js。這個看似瑣碎的約定,能讓人在一堆 js 檔案裡一眼分辨哪些是外掛、哪些是業務程式。
物件級外掛的所有方法都應依附於 jQuery.fn(也就是 $.fn);類級外掛則依附於 jQuery 本身。這條與第 1 點是一體兩面。
無論哪一種外掛,IIFE 的最後都要以分號結束。少這一分號,在檔案被壓縮合併之後極可能與前一段程式碼黏在一起,引發難以定位的語法錯誤。
$ 只是 jQuery 的別名,但這個符號也被 Prototype、MooTools 等函式庫使用。外掛內部不要直接依賴全域 $,標準做法是用 IIFE 把 jQuery 傳進來:
(function ($) {
// 這個 $ 一定是 jQuery,安全
$.fn.myPlugin = function () { /* ... */ };
})(jQuery);
外掛被呼叫時,this 是選到的元素集合。要對每個元素逐一處理,用 this.each(function(){ ... }),而不是自己寫 for 迴圈去索引。
這是最容易搞混的一點:外掛外層的 this 是 jQuery 物件(元素集合),不是原生 DOM 元素;而進入 each 的回呼之後,this 才變成單一的原生 DOM 元素。所以 $(this) 才能對它呼叫 jQuery 方法。搞錯這層,就會出現「this.attr() is not a function」這類錯誤。
jQuery 最迷人的特性之一是鏈寫:$('#a').pluginA().pluginB().css(...)。要讓這招成立,外掛必須 return this(或 return this.each(...),因為 each 本身就回傳原集合)。忘記回傳,鏈條就斷在那裡。
很多開發者能寫出功能強大的外掛,卻忽略了對使用者的友善度:參數沒有預設值、沒有文件、行為寫死無法調整。與其在功能上追逐,不如先想清楚 API 設計——參數怎麼傳、狀態存哪裡、對外開放哪些方法、要不要提供 destroy 以便反初始化。好的骨架帶來的長期效益,遠大於零散的技巧累積。