DIV CSS 佈局教程網

jQuery 外掛開發八大注意事項整理
編輯:JQuery特效代碼     

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

1. 分清物件級與類級,用對的擴充方法

針對選到的元素做操作的「物件級」外掛,用 jQuery.fn.extend() 擴充;提供工具函式、不綁定在元素集合上的「類級」外掛,用 jQuery.extend()。兩者對應的掛載位置不同,用錯就會找不到方法。

2. 檔案命名要能被辨識

遵循 jquery.[外掛名].js 的命名慣例,例如 jquery.newplugin.js。這個看似瑣碎的約定,能讓人在一堆 js 檔案裡一眼分辨哪些是外掛、哪些是業務程式。

3. 方法掛在正確的主體上

物件級外掛的所有方法都應依附於 jQuery.fn(也就是 $.fn);類級外掛則依附於 jQuery 本身。這條與第 1 點是一體兩面。

4. 結尾必須加分號

無論哪一種外掛,IIFE 的最後都要以分號結束。少這一分號,在檔案被壓縮合併之後極可能與前一段程式碼黏在一起,引發難以定位的語法錯誤。

5. 小心全域 $ 的衝突

$ 只是 jQuery 的別名,但這個符號也被 Prototype、MooTools 等函式庫使用。外掛內部不要直接依賴全域 $,標準做法是用 IIFE 把 jQuery 傳進來:

(function ($) {
    // 這個 $ 一定是 jQuery,安全
    $.fn.myPlugin = function () { /* ... */ };
})(jQuery);

6. 用 this.each 遍歷元素集合

外掛被呼叫時,this 是選到的元素集合。要對每個元素逐一處理,用 this.each(function(){ ... }),而不是自己寫 for 迴圈去索引。

7. 理解外掛內 this 的含義

這是最容易搞混的一點:外掛外層的 this 是 jQuery 物件(元素集合),不是原生 DOM 元素;而進入 each 的回呼之後,this 才變成單一的原生 DOM 元素。所以 $(this) 才能對它呼叫 jQuery 方法。搞錯這層,就會出現「this.attr() is not a function」這類錯誤。

8. 一定要回傳 jQuery 物件

jQuery 最迷人的特性之一是鏈寫:$('#a').pluginA().pluginB().css(...)。要讓這招成立,外掛必須 return this(或 return this.each(...),因為 each 本身就回傳原集合)。忘記回傳,鏈條就斷在那裡。

架構比技巧重要

很多開發者能寫出功能強大的外掛,卻忽略了對使用者的友善度:參數沒有預設值、沒有文件、行為寫死無法調整。與其在功能上追逐,不如先想清楚 API 設計——參數怎麼傳、狀態存哪裡、對外開放哪些方法、要不要提供 destroy 以便反初始化。好的骨架帶來的長期效益,遠大於零散的技巧累積。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved