很多老專案裡,jQuery 和 Prototype、YUI 這類同樣把 $ 當成主要別名的函式庫會撞在一起。誰後載入,誰就搶走 $,另一邊的 code 立刻大面積失效。
jQuery 官方留了逃生門:jQuery.noConflict()。它做的事很單純——把 $ 的 control 權交還給先前那個庫,而 jQuery 本身仍可透過 jQuery 這個名稱使用。
呼叫 noConflict() 之後,全域的 $ 不再指向 jQuery。若你還想用慣的 $ 寫法,用立即執行函式把它當參數傳進來,形成一個只在自己作用域內有效的別名:
jQuery.noConflict();
(function ($) {
$(function () {
// 這個區塊裡,$ 就是 jQuery
});
})(jQuery);
// 這裡的 $ 已經是其他庫的別名,可以照舊使用
這種寫法的好處是:既有 code 幾乎不用改,只要整段包進 IIFE 即可,汙染也降到最低。
如果你不介意換名字,直接把 noConflict() 的回傳值指定給新變數:
var j = jQuery.noConflict();
// 之後一律用 j
j("div p").hide();
// 原本的 $ 留給其他庫
$("content").style.display = 'none';
這個方式更直白,也更容易讓同事看出「這段是 jQuery、那段是別的庫」。
noConflict() 必須在 jQuery 檔案之後、造成衝突的那個庫之前呼叫。順序錯了,交還的對象就不是你要的那個,問題依舊存在。
<script src="jquery.js"></script>
<script>jQuery.noConflict();</script>
<script src="prototype.js"></script>
另外一個實務建議:團隊協作時,把「本專案 jQuery 一律用哪個別名」寫進開發規範,避免有人寫 $、有人寫 jQuery,最後誰也搞不清楚哪裡會出錯。