DIV CSS 佈局教程網

解決 jQuery 與 prototype.js 的 $ 符號命名衝突
編輯:關於JavaScript     

前些天幫朋友處理一個頁面上 jQuery 特效的相容性問題。這個問題很好忽略,但影響很實際,值得記錄一下。

那個頁面用到三個特效,其中兩個正常顯示,第三個完全沒反應。查看引用的 JS 檔後發現,頁面除了 jQuery 之外還載入了 prototype.js——這也是一套 JavaScript 函式庫,功能與 jQuery 頗為相似,而且相當強大。

逐步排查後確認:能顯示的那兩個特效用的是 jQuery,沒反應的那個用的是 prototype.js。

原因就在這裡:兩個函式庫都用 $ 作為主要呼叫符號。頁面同時載入兩者時,後載入的會覆蓋掉前者的 $,於是原本寫給 jQuery 的程式碼實際上呼叫到了 prototype.js 的方法,自然就不會動。

方法一:改用 jQuery 這個名稱

jQuery 原始碼中有這麼一段:

// Expose jQuery to the global object
window.jQuery = window.$ = jQuery;

也就是說,jQuery 除了 $ 之外,也可以用 jQuery 這個名稱呼叫。只要先宣告:

jQuery = $;

就能用 jQuery 取代 $。

但實務上這個方法很難推廣:頁面裡到處都是 $,你不只要分辨哪些屬於 jQuery,還得逐處替換;之後每寫一段新的 jQuery 程式碼,都要提醒自己別忘了用 jQuery 代替 $。稍一疏忽,效果出不來不說,除錯成本還很高。

方法二:用 jQuery 語句塊隔離作用域(推薦)

更好的做法是把 jQuery 的程式碼包在一個立即執行函數裡,透過參數把 jQuery 傳進來:

(function ($) {
  // 這個區塊內的 $ 保證屬於 jQuery
  $('#msg').show();
})(jQuery);

這樣一來,區塊內的 $ 該怎麼用就怎麼用,而 prototype.js 寫在區塊外的 $ 也照樣能正常運作,兩邊互不干擾。

這也是為什麼現在的 jQuery 外掛幾乎都長這個樣子——它同時解決了命名衝突與全域汙染兩個問題。

還有一招:jQuery.noConflict()

補充一個官方提供的做法。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() 加上語句塊隔離,兩者搭配使用,就能徹底擺脫 $ 歸屬權的糾紛。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved