前些天幫朋友處理一個頁面上 jQuery 特效的相容性問題。這個問題很好忽略,但影響很實際,值得記錄一下。
那個頁面用到三個特效,其中兩個正常顯示,第三個完全沒反應。查看引用的 JS 檔後發現,頁面除了 jQuery 之外還載入了 prototype.js——這也是一套 JavaScript 函式庫,功能與 jQuery 頗為相似,而且相當強大。
逐步排查後確認:能顯示的那兩個特效用的是 jQuery,沒反應的那個用的是 prototype.js。
原因就在這裡:兩個函式庫都用 $ 作為主要呼叫符號。頁面同時載入兩者時,後載入的會覆蓋掉前者的 $,於是原本寫給 jQuery 的程式碼實際上呼叫到了 prototype.js 的方法,自然就不會動。
jQuery 原始碼中有這麼一段:
// Expose jQuery to the global object
window.jQuery = window.$ = jQuery;
也就是說,jQuery 除了 $ 之外,也可以用 jQuery 這個名稱呼叫。只要先宣告:
jQuery = $;
就能用 jQuery 取代 $。
但實務上這個方法很難推廣:頁面裡到處都是 $,你不只要分辨哪些屬於 jQuery,還得逐處替換;之後每寫一段新的 jQuery 程式碼,都要提醒自己別忘了用 jQuery 代替 $。稍一疏忽,效果出不來不說,除錯成本還很高。
更好的做法是把 jQuery 的程式碼包在一個立即執行函數裡,透過參數把 jQuery 傳進來:
(function ($) {
// 這個區塊內的 $ 保證屬於 jQuery
$('#msg').show();
})(jQuery);
這樣一來,區塊內的 $ 該怎麼用就怎麼用,而 prototype.js 寫在區塊外的 $ 也照樣能正常運作,兩邊互不干擾。
這也是為什麼現在的 jQuery 外掛幾乎都長這個樣子——它同時解決了命名衝突與全域汙染兩個問題。
補充一個官方提供的做法。jQuery 內建 noConflict() 方法,可以把 $ 的控制權「還給」先載入的函式庫:
<script src="prototype.js"></script>
<script src="jquery.js"></script>
<script>
// 把 $ 還給 prototype.js,jQuery 改用 jQuery 名稱存取
jQuery.noConflict();
// 此處 $ 屬於 prototype.js
$('div1').hide();
// jQuery 則用 jQuery 呼叫
jQuery('#msg').show();
</script>
實際專案中最乾淨的組合是:noConflict() 加上語句塊隔離,兩者搭配使用,就能徹底擺脫 $ 歸屬權的糾紛。