$ 並不是 jQuery 獨占的符號。Prototype、MooTools 等舊框架都用它當作主要入口,一旦同一頁同時載入,後載入的會覆蓋掉前者的 $,兩邊的程式碼都開始出錯。
jQuery.noConflict() 的作用就是把 $ 的控制權讓回給最早實作它的那個函式庫,jQuery 則退回到使用自己的全名 jQuery。
必須在載入 jQuery 之後、並且在載入另一個會衝突的函式庫「之前」執行。順序錯了,讓出的就不是自己那份了。
<script type="text/javascript" src="/javascripts/jquery.js"></script> <script type="text/javascript"> var j$ = $; jQuery.noConflict(); </script> <script type="text/javascript" src="/javascripts/prototype.js"></script>
執行後,jQuery 物件只能透過 jQuery 或你自己存下的別名(例如上例的 j$)存取;原本要寫 $("div p") 的地方,就得改寫成 j$("div p")。
jQuery.noConflict();
// 使用 jQuery
j$("div p").hide();
// 使用其他函式庫的 $
$("content").style.display = 'none';
noConflict() 會回傳 jQuery 物件,可以直接指定給任何變數名,語意更清楚:
// 我的一個站點
var keleyi = jQuery.noConflict();
// 基於 jQuery 的程式碼
keleyi("div p").hide();
// 基於其他函式庫的 $ 程式碼
$("content").style.display = 'none';
也可以不全域讓出,而是用立即函式把 jQuery 當參數傳進去,在閉包內安全地使用 $,這也是 jQuery 外掛開發的標準寫法:
(function($){
// 這個範圍內的 $ 就是 jQuery
$("div p").hide();
})(jQuery);
這樣一來,就不必為了框架之間的 $ 衝突而改動整份程式碼了。