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 是 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),方案一則僅適合小型、單檔案的簡單頁面。