多個 JavaScript 庫(Prototype、MooTools、Zepto 等)皆使用 $ 作為核心函數別名。當 jQuery 載入後覆寫 $,導致其他庫失效。
<script src="prototype.js"></script>
<script src="jquery.js"></script>
<script>
// 必須在使用 $ 之前調用
jQuery.noConflict();
// 此後只能使用 jQuery,不能使用 $
jQuery(document).ready(function($) {
// 此閉包內 $ 安全指向 jQuery
$("div").hide();
});
// 外部使用 prototype 的 $
$("someElement").hide(); // prototype 語法
</script>
<script src="jquery.js"></script>
<script>
// 指定專屬別名
var $j = jQuery.noConflict();
// 使用 $j 操作 jQuery
$j("#myDiv").html("jQuery 工作正常")
.css({ border: "2px solid black", "background-color": "#ddddff" });
// $ 保留給其他庫
$("otherLibElement").someMethod();
</script>
<script src="jquery.js"></script>
<script>
jQuery.noConflict();
(function($) {
// 此處 $ 專屬 jQuery
$(function() {
$("button").click(function() {
$("p").text("jQuery 正常運作");
});
});
})(jQuery);
// 外部 $ 歸還給其他庫
</script>
<script src="jquery-1.7.2.js"></script>
<script> var $jq17 = jQuery.noConflict(true); </script>
<script src="jquery-3.6.0.js"></script>
<script> var $jq36 = jQuery.noConflict(true); </script>
<script>
$jq17("#oldPlugin").legacyPlugin();
$jq36("#newFeature").modernPlugin();
</script>
noConflict(true) 同時釋放 jQuery 和 $,需立即存入變數。
noConflict() → 自訂別名import $ from 'jquery',避免全域污染(function($){ ... })(jQuery) 封裝,不依賴全域 $$ 替換為 jQuery 或專屬別名var $ = jQuery.noConflict(); — 這會覆寫回 $,失去隔離效果noConflict() 前使用 $ 寫 jQuery 代碼var $j = jQuery.noConflict(); 或 IIFE 封裝