當頁面引入 jQuery 與 Prototype、MooTools 等同樣使用 $ 符號的庫時,會發生命名空間衝突。jQuery 提供 $.noConflict() 機制釋放 $ 控制權,並支援多種作用域隔離模式,確保多庫共存穩定運行。本文系統講解三種核心解決方案與插件開發最佳實踐。
$ 作為 jQuery 的別名$ 作為核心函數$ 定義<script src="prototype.js"></script>
<script src="jquery.js"></script>
<script>
$('#msg').hide(); // $ 指向 jQuery
// Prototype 的 $ 已被覆蓋,不可用
</script>
<script src="jquery.js"></script>
<script src="prototype.js"></script>
<script>
$('#msg').hide(); // $ 指向 Prototype,報錯!
jQuery('#msg').hide(); // 必須用全稱
</script>
<script src="prototype.js"></script>
<script src="jquery.js"></script>
<script>
// 釋放 $,歸還給 Prototype
var $j = jQuery.noConflict(); // 返回 jQuery 引用,可自定義別名
// 此後 $ 屬於 Prototype
$('element').hide(); // Prototype 寫法
// jQuery 必須用 $j 或 jQuery
$j('#msg').hide();
jQuery('#msg').hide();
</script>
關鍵點:必須在所有庫載入後、業務代碼前調用。
var $j = jQuery.noConflict();
// 或簡寫
var $j = $.noConflict();
$j(document).ready(function() {
$j('#msg').hide(); // 使用 $j
});
// $ 仍歸其他庫所有
<script src="jquery.js"></script>
<script src="prototype.js"></script>
<script>
(function($) {
// 此作用域內 $ 確定指向 jQuery
$('#msg').hide(); // 安全使用 $
// 插件開發範例
$.fn.myPlugin = function() {
return this.each(function() {
$(this).addClass('processed');
});
};
})(jQuery); // 傳入 jQuery,參數命名為 $
// 外部 $ 不受影響,屬於 Prototype
$('element').hide(); // Prototype
jQuery(function($) {
// 就緒回調內 $ 綁定為 jQuery
$('#msg').hide();
});
等價於 (function($){ ... })(jQuery),但語義更清晰:DOM 就緒後執行。
(function($) {
// 1. 創建匿名函數,參數名為 $
// 2. 立即調用,傳入實參 jQuery
// 3. 函數內部 $ 遮蔽外部同名變量(作用域鏈優先級)
// 4. 內部代碼只見到參數 $,即 jQuery
})(jQuery);
這是 JavaScript 閉包與作用域鏈的經典應用,確保插件內部不受外部 $ 變更影響。
;(function($, window, document, undefined) {
// 1. 分號開頭防止前文遺漏分號導致合併報錯
// 2. 參數化 window/document/undefined 防止被篡改、壓縮優化
// 3. 內部盡用 $,外部不污染
$.fn.myPlugin = function(options) {
// 插件邏輯
};
})(jQuery, window, document);
jQuery 全稱或自定義別名 $j,避免 $ 衝突(function($){ ... })(jQuery)