DIV CSS 佈局教程網

JavaScript 插件化開發(一):從 jQuery 插件的三種寫法談起
編輯:關於JavaScript     

為什麼談插件化

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

jQuery 插件的兩大類

一般來說,jQuery 插件開發分為兩種:掛在 jQuery 命名空間下的全域函式(靜態方法),以及掛在 jQuery 原型上的物件層級方法——後者能讓所有透過選擇器取得的 jQuery 實例共享。

(1)類別層級:加上靜態方法

最直接的理解就是給 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)物件層級:擴充原型

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 非同步取回的內容。

幾個值得記住的實踐

  1. 提供預設參數:用 $.fn.pluginName.defaults 搭配 extend,讓使用者依需求自訂選項並控制插件行為。擴充性良好的插件一定保留恢復預設值的能力。
  2. 用 return this.each() 保留鏈式呼叫:jQuery 的 Sizzle 選擇器引擎可以一次選到多個元素,this.each 讓插件天生支援多元素操作;同時 return 一個 jQuery 物件才能維持方法級聯(鏈式呼叫)不被破壞。
  3. 把程式碼放進閉包:立即執行函式形成私有作用域,外部無法存取內部資訊,也不會污染全域變數。官方規範的理由是:避免全域依賴、避免第三方破壞、兼容 $ 與 jQuery 兩個操作符。
  4. 一次性程式碼放在主循環之外:如果某段程式碼只是一堆預設值、只需建立一次,就不要放在每次呼叫插件時都會執行的位置。

官方提供的兩個擴充入口是 jQuery.fn.extend(object)(給 jQuery 實例添加方法)與 jQuery.extend(object)(擴展 jQuery 類本身,添加靜態方法),選哪一個取決於你的 API 要服務「元素集合」還是「全域工具」。

留一個問題

如果專案的技術選型換掉,而這些插件又強依賴 jQuery 機制,我們過去寫的插件就全部報廢了(假設不再使用 jQuery)。這時該怎麼重構?下一篇就來處理這個問題,並重新組織插件的關鍵邏輯。

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