同一頁面上同時使用 jQuery 與 Prototype 時,最大的爭議點就是全域名稱 $。jQuery 把 $ 當作自己的別名,而 Prototype 等函式庫也使用同樣的名字,誰後載入誰就搶走所有權。
$.noConflict(jqueryToo);
呼叫這個方法後,$ 的控制權會還給其他函式庫,之後必須改用 jQuery 標識符來呼叫 jQuery 的功能。
可選參數 jqueryToo 若設為 true,連 jQuery 這個全域名稱也會一併釋放,之後兩者都不可用,需自行建立別名。
// 執行 noConflict 之後,建立自己的短別名 var $j = jQuery;
呼叫時機很關鍵:應該在載入 jQuery 之後、載入衝突函式庫之前執行,這樣 jQuery 才能把 $ 交還出去。
更常見的習慣是建立一個封閉環境,在其中讓 $ 專指 jQuery:
(function ($) {
// 這個區塊內的 $ 一定是 jQuery
// 外部若有其他函式庫定義的 $,在此不可用
})(jQuery);
拆解來看:(function($) { ... }) 用圓括號包住函式宣告,使之成為一個運算式,結果是一個匿名函式的參照;這個函式期望接收單一參數並命名為 $;最後的 (jQuery) 把 jQuery 物件傳進去。
因為函式的參數宣告優先於全域作用域中的同名識別符,所以無論外部的 $ 被誰佔用,函式體內的 $ 永遠指向 jQuery。這個技巧對外掛作者特別重要——他們無法預設頁面開發者是否呼叫過 noConflict(),也不該自行呼叫以免破壞對方的決定。
把上面的技巧套進 ready 回呼,形成第三種常見語法:
jQuery(function ($) {
// DOM ready 後執行,且 $ 在此為 jQuery
$('.some-class').hide();
});
jQuery 會把 jQuery 物件傳給 ready 的回呼函式,因此只要宣告參數名為 $,裡面就能安心使用熟悉的語法,不必污染全域。
$.noConflict(),然後用 jQuery 全名或自訂別名。jQuery(function ($) { ... }) 最簡潔,同時解決了 DOM ready 與 $ 命名兩件事。ES 模組(import/export)與打包工具已經從根本上移除了這個問題:每個模組都有自己的作用域,$ 不會外洩到全域,也就不需要 noConflict。
import $ from 'jquery'; // 這個檔案中的 $ 只屬於自己
在仍使用全域 <script> 標籤的舊專案中,IIFE 包裝依然是必備習慣;但在新專案裡,改用模組化會比學習這些衝突處理技巧更值得。