jQuery 大量依賴 $ 這個簡寫,但如果頁面上同時載入了 Prototype、MooTools 等也定義了 $ 的函式庫,就會互相覆蓋,導致程式碼執行異常。jQuery 官方提供了幾種因應方式,但它們的適用範圍差別很大。
var $j = jQuery.noConflict();
$j(document).ready(function () {
$j("#btn1").click(function () {
alert("Text: " + $j("#test").text());
});
});
缺點:一旦呼叫 noConflict(),這個 HTML 頁面所引用的所有 JS 檔案中,原本寫的 $ 都必須改成 $j。牽一髮動全身,維護成本最高。
jQuery(document).ready(function ($) {
// 這個範圍內的 $ 就是 jQuery
});
缺點:只在 ready 的閉包內有效。實務上我們通常會在 ready 之外寫一些輔助函式,再由 ready 呼叫它們,這些函式裡的 $ 依然是衝突的,所以這個方案有明顯的局限性。
jQuery(function ($) {
// 你的所有程式碼放這裡,包含 ready 邏輯與子函式
});
// 或者寫成更直觀的形式
(function ($) {
// 你的程式碼
})(jQuery);
這個做法沒有前兩個方案的缺點,因為 $ 只在這個函式作用域內被重新指向 jQuery,不會污染全域,也不影響其他函式庫。
想像你寫了一個需要依賴 jQuery 的公共元件,要發布給其他團隊使用。若採用方案一,所有使用你元件的人都得遵守你的約定,把自己程式碼裡的 $ 改名;而採用方案三,既保護了元件不受 $ 衝突影響,又不對使用方提出任何額外要求。這就是「把影響範圍收到最小」的封裝精神。
// 把 $ 還給 Prototype,jQuery 自己改用 jQuery 名稱 jQuery.noConflict(); // 完全釋放 $ 與 jQuery 兩個名稱 var jQ = jQuery.noConflict(true);