萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery $ 符號衝突完整解決方案:noConflict() 四種用法詳解

問題背景

jQuery 佔用 $ 作為核心別名,但 Prototype、MooTools 等庫也使用 $。當多庫共存時,$ 指向最後載入的庫,導致 jQuery 失效。

核心 API:jQuery.noConflict()

釋放 $ 控制權,回傳 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>

方法二:自訂短別名(如 $j)

<script>
  var $j = jQuery.noConflict(); // $ 歸還,$j 代表 jQuery
  $j(function () {
    $j("p").click(function () { alert($j(this).text()); });
  });
  $("content").style.display = "none"; // Prototype
</script>

方法三:ready 回調參數接收 $(推薦)

<script>
  jQuery.noConflict();
  jQuery(function ($) {
    // 回調參數 $ 綁定 jQuery,內部可直接用 $
    $("p").click(function () { alert($(this).text()); });
  });
  $("content").style.display = "none";
</script>

優點:無需修改既有代碼風格,作用域限制在 ready 回調內。

方法四:IIFE 封裝傳入 jQuery(插件開發常用)

<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 封裝插件/模組開發作用域隔離,標準模式
copyright © 萬盛學電腦網 all rights reserved