jQuery 佔用 $ 作為核心別名,但 Prototype、MooTools 等庫也使用 $。當多庫共存時,$ 指向最後載入的庫,導致 jQuery 失效。
釋放 $ 控制權,回傳 jQuery 物件供自訂別名使用。
<script src="prototype.js"></script>
<script src="jquery.js"></script>
<script>
jQuery.noConflict(); // $ 歸還給 Prototype
jQuery(function ($) {
// 這裡 $ 又是 jQuery(IIFE 參數遮蔽)
$("p").click(function () { alert($(this).text()); });
});
// 外部 $ 是 Prototype
$("content").style.display = "none";
</script>
<script>
var $j = jQuery.noConflict(); // $ 歸還,$j 代表 jQuery
$j(function () {
$j("p").click(function () { alert($j(this).text()); });
});
$("content").style.display = "none"; // Prototype
</script>
<script>
jQuery.noConflict();
jQuery(function ($) {
// 回調參數 $ 綁定 jQuery,內部可直接用 $
$("p").click(function () { alert($(this).text()); });
});
$("content").style.display = "none";
</script>
優點:無需修改既有代碼風格,作用域限制在 ready 回調內。
<script>
jQuery.noConflict();
(function ($) {
$(function () {
$("p").click(function () { alert($(this).text()); });
});
})(jQuery);
$("content").style.display = "none";
</script>
優點:模組化、不汙染全域、插件標準寫法。
<!-- 1. 先載入其他佔用 $ 的庫 -->
<script src="prototype.js"></script>
<!-- 2. 再載入 jQuery -->
<script src="jquery.js"></script>
<!-- 3. 立即呼叫 noConflict() 釋放 $ -->
<script>jQuery.noConflict();</script>
<!-- 4. 之後的代碼 $ 指向 Prototype,jQuery 用 jQuery 或自訂別名 -->
⚠️ 若 jQuery 載入在最後,$ 已被它佔用,noConflict() 才能歸還給先前的庫。
使用 ES Modules / Webpack / Rollup 時:
// main.js
import $ from "jquery";
import _ from "lodash"; // 不衝突
// 或明確命名
import jQuery from "jquery";
window.jQuery = jQuery; // 僅在需掛全域時
// $ 保持區域變數,零衝突
模組化天然隔離作用域,不再需要 noConflict()。
| 方法 | 適用場景 | 優點 |
|---|---|---|
| 完全放棄 $ | 舊專案快速修復 | 零改動既有 jQuery 代碼(除 $→jQuery) |
| 自訂別名 $j | 團隊習慣短別名 | 語意清晰 |
| ready 回調參數 | 大多數專案 | 內部保持 $ 風格,外部不受影響 |
| IIFE 封裝 | 插件/模組開發 | 作用域隔離,標準模式 |