DIV CSS 佈局教程網

jQuery 外掛開發完整指南:從入門到最佳實踐
編輯:JQuery特效代碼     

為 jQuery 擴充外掛與方法,是提升開發效率的一大利器,能幫我們省下大量重複勞動的時間。本文將系統性地帶你走過 jQuery 外掛開發的核心知識,並整理實戰中的最佳做法與那些容易踩到的坑。

一、起手式:建立你的第一個外掛

撰寫 jQuery 外掛的起點,是往 jQuery.fn 上掛載一個新的屬性,這個屬性的名稱,就是外掛的名字:

那麼大家最熟悉的 $ 符號去哪了?它其實還在。只是為了避免與其他 JavaScript 函式庫(例如 Prototype)發生衝突,我們最好把 jQuery 傳入一個立即執行的閉包中,在閉包內將它映射回 $:

如此一來,在這個閉包裡就能放心大膽地使用 $ 來代表 jQuery,不必擔心被別的函式庫覆寫。

二、搞懂執行環境中的 this

開始寫實際邏輯之前,得先對外掛所在的環境有個概念。在外掛的範圍裡,this 代表的是外掛即將作用的 jQuery 物件。這裡藏著一個常見誤區:在其他帶 callback 的 jQuery 方法中,this 指向的是原生 DOM 元素。因此不少開發者會誤把 this 多包一層 $(this),其實完全沒有必要,因為此時的 this 早已是 jQuery 物件了。

三、動手做個小外掛

理解了基礎之後,我們來寫一個真正會做事的外掛——找出頁面上高度最高的 div 元素,並回傳它的高度:

這個外掛透過 this.each 逐一走訪元素,再用 .height() 比較取最大值,寫法簡潔而直觀。

四、維持 Chainability(鏈式呼叫)

很多時候,外掛的目的只是以某種方式調整選到的元素,然後把它交棒給鏈上的下一個方法。這正是 jQuery 設計之美,也是它廣受歡迎的原因之一。要維持鏈式呼叫,關鍵在於讓外掛回傳 this:

因為外掛回傳了 this,鏈式能力得以延續,後續就能繼續串接 .css() 等方法。原則很簡單:只要外掛不需要回傳特定數值,就應該一律回傳 this。此外,傳入外掛的參數也會在外掛範圍內被接收,例如字串 'width' 就變成了 type 參數。

五、預設值與選項設定

對於較複雜、需要高度客製化的外掛,最好的做法是透過 $.extend 提供一組可被覆寫的預設設定。如此一來,呼叫時只需傳入一個物件參數,指定想覆寫的項目即可,而不必定義一大堆位置參數。

在 tooltip 的範例中,呼叫時覆寫了 location,而 background-color 則保留預設值,最終生效的設定為 location 為 left、background-color 為 blue。這是打造靈活、可高度設定外掛的關鍵手法。

六、命名空間的重要性

為外掛正確地劃分命名空間,是外掛開發中極重要的一環。良好的命名空間能大幅降低外掛被其他外掛或同頁程式碼覆蓋的風險,同時也讓你身為開發者更容易追蹤自己的方法、事件與資料。

七、外掛方法:單一入口的優雅架構

任何情況下,單一外掛都不應該在 jQuery.fn 上散落成多個命名空間。把 tooltip、tooltipShow、tooltipHide、tooltipUpdate 各自掛上去,會讓 $.fn 的命名空間變得混亂。

正解是把所有方法收攏進一個 methods 物件裡,再透過傳入方法名稱的字串來呼叫對應方法。這種把方法封裝在父容器、以字串名稱加參數來分派呼叫的架構,是 jQuery 外掛社群的標準做法,jQuery UI 的諸多 widget 也都採用這種模式。

八、為事件加上命名空間

bind 方法有個鮮為人知的特性:支援事件命名空間。當外掛要綁定事件時,替它加上命名空間是很好的習慣。做法是透過 .<namespace> 附加到事件名稱後面。

在範例中,tooltip 於 init 初始化時,把 reposition 方法綁到 resize 事件,並透過附加 .tooltip 為它命名。之後當需要銷毀外掛時,只要傳入 .tooltip 命名空間,就能精準地解除 reposition 與 resize 的綁定,而不會誤傷外掛之外的其他事件綁定。

九、用 data 管理外掛資料

開發外掛時,常需要記錄或檢查某元素是否已被初始化。jQuery 的 data 方法是依元素存放狀態變量的好幫手。比起散落地記錄一堆不同名稱的 data,更好的做法是把所有變量收進單一物件,並以單一命名空間統一讀取。

把資料透過命名空間封裝在同一個物件裡,就能從集中一處輕鬆讀寫外掛的所有屬性,程式碼結構也更清爽。

十、總結與最佳實踐

撰寫 jQuery 外掛,讓你能把最實用的功能沉澱為可重複使用的程式碼,既省時又高效。動手時請牢記以下要點:

1. 一律用閉包包住外掛。

2. 不要在外掛範圍內多此一舉地把 this 再包一層。

3. 除非要回傳特定值,否則一律回傳 this 以維持鏈式能力。

4. 傳入可擴充的預設物件參數,而非一堆散亂的參數。

5. 不要在單一外掛中散開命名多個方法。

6. 為方法、事件與資料都加上命名空間。

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