DIV CSS 佈局教程網

jQuery 的 $ 被別的函式庫搶走?三種 noConflict 解法比較
編輯:JQuery特效代碼     

jQuery 用 $ 作為簡寫,但 Prototype、部分字型或統計腳本也愛用 $。兩個函式庫同時載入時,後者會覆蓋前者,$ 不再指向 jQuery,整頁的 jQuery 程式碼就跟著失效。

jQuery 提供了 noConflict() 來處理這件事:

var ¥ = jQuery.noConflict();

這行的作用是釋放 jQuery 對 $ 的控制權,並把 jQuery 物件交給你自己指定的變數(本例是 ¥)。以下比較三種常見搭配方式,以及各自的限制。

方案一:全域替換 $ 名稱

引入 noConflict() 後,用新名稱取代原本的 $:

var $j = jQuery.noConflict();

$j(document).ready(function () {
    $j("#btn1").click(function () {
        alert("Text: " + $j("#test").text());
    });
});

缺點:這個改名是全域的。該頁面所引用的每一個 JS 檔,只要原本寫了 $,全都得改成 $j。檔案一多就很難維護,也很容易漏改。

方案二:在 ready 的參數中接收 $

ready 是 jQuery 的入口函式,它會把 jQuery 物件當作參數傳給回呼:

jQuery(document).ready(function ($) {
    // 這個作用域內的 $ 就是 jQuery
});

缺點:只在 ready 的回呼函式內部有效,外部無效。如果所有邏輯都寫在 ready 裡,這樣就夠了;但實務上我們通常會在 ready 之外定義一堆子函式,再由 ready 呼叫它們——這些子函式裡的 $ 仍然是壞的。因此這個方案有明顯的侷限。

方案三(推薦):用閉包包住整份程式碼

把整個檔案包進一個函式,並把 jQuery 當參數傳進去:

jQuery(function ($) {
    // 你的所有 JS 程式碼放這裡
    // 包含 ready 回呼與所有子函式
});

或者寫成更常見的形式:

(function ($) {
    // 你的所有 JS 程式碼
})(jQuery);

這個做法沒有前兩個方案的缺點:作用域只限於被包起來的程式碼,不會影響同頁其他 JS 檔。

這一點在寫共用元件或外掛時尤其關鍵。想像你寫了一個需要 jQuery 的公共模組,目的是提高穩健性、不預期使用者怎麼設定環境。若採用方案一,使用者在引入你的模組後,還得遵守你的約定,把自己程式碼裡的 $ 全部改名——這對使用者是種負擔,也容易出錯。而方案三既保護了你的模組不受 $ 衝突影響,又不要求使用者改動任何程式碼。

順帶一提:載入順序

如果無法修改任何程式碼,還有一個消極解法:調整載入順序,把 jQuery 放在衝突函式庫之後引入,讓 jQuery 最後取得 $ 的控制權。但這只是把問題推給對方,雙方誰都沒有安全感,不建議作為長期方案。

結論

優先選方案三。它一行開頭、一行結尾,卻能同時解決作用域隔離與 $ 衝突兩個問題,也是絕大多數 jQuery 外掛的標準開頭。方案二可以視情況搭配使用(例如只需要保護一小段 inline script),方案一則僅適合小型、單檔案的簡單頁面。

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