在 jQuery 裡,$ 只是 jQuery 的別名,$('#msg') 等同 jQuery('#msg')。問題是 Prototype、MooTools 等函式庫也愛用 $,一旦同時載入,就會互相搶走這個符號。
情況一:prototype.js 先,jquery.js 後
<script src="prototype.js"></script>
<script src="jquery.js"></script>
$('#msg').hide(); // 這裡的 $ 是 jQuery 的
後載入者勝出,所以 $ 屬於 jQuery。
情況二:jquery.js 先,prototype.js 後
<script src="jquery.js"></script>
<script src="prototype.js"></script>
$('#msg').hide(); // 這裡的 $ 是 Prototype 的,會出錯
jQuery('#msg').hide();// 只能用全稱
這個方法讓 jQuery 交出 $ 的所有權,還給先佔用的函式庫,它的回傳值就是 jQuery 物件本身。
jQuery.noConflict();
// 此後 $('#msg') 是 Prototype 的 $,不可再用
jQuery('#msg').hide();
var $j = jQuery.noConflict();
$j('#msg').hide(); // $j 成為 jQuery 的短名
這是最實用的做法,既避開衝突,又保有簡短的呼叫形式。
jQuery(document).ready(function ($) {
$('#msg').hide(); // 這個 ready 回呼內的 $ 一定是 jQuery
});
或者用 IIFE 立即建立獨立作用域:
(function ($) {
// ...
$('#msg').hide(); // 這個區塊內的 $ 都是 jQuery
})(jQuery);
若 Prototype 是後載入的,這招同樣有效,因為我們是明確把 jQuery 傳進去當參數,不受全域 $ 被誰覆蓋影響。
(function(){})() 這種寫法是「建立匿名函式並立刻執行」。它製造出一個獨立作用域,內部的 $ 不會外洩,外部的 $ 也不會污染內部。由於你無法預知使用者的頁面會以什麼順序載入哪些函式庫,這種封裝是唯一能保證插件在任何環境都不衝突的寫法:
(function ($) {
$.fn.myPlugin = function (options) {
// 在這裡自由使用 $,不必擔心與外界衝突
return this.each(function () { /* ... */ });
};
})(jQuery);
仔細拆解:(function(){})() 建立並立即執行匿名函式,形成封閉作用域;(function($){})(jQuery) 則在此基礎上把 jQuery 當參數傳入,在內部命名為 $。因為 jQuery 內部 $ 與 jQuery 本是同一個東西,這樣重新命名後,插件內部就能安全地使用熟悉的 $ 語法,而完全不理会全域命名空間的狀態。
IIFE 不只解決衝突,還能避免全域變數污染。插件內宣告的暫存變數都留在函式作用域裡,不會附在 window 上與其他程式打架。在 ES Module 普及之前,這是 JavaScript 做模組化的主力手法;今天寫 jQuery 插件時,這依然是標準起手式。