如果你同時在頁面裡引入了 jQuery 與 Prototype 這類函式庫,很可能會遇到一個惱人的問題:兩邊都想搶用 $ 這個變數。本文就來談談衝突的成因,以及四種可以直接套用的解決寫法。
jQuery 把 $ 當成取得 DOM 節點的快捷方式,透過它選取元素、操作節點。但問題在於,$ 並不是 jQuery 的專利,Prototype.js 等眾多優秀的函式庫同樣使用 $。當這兩個(或更多)函式庫同時出現在同一個頁面時,$ 的所有權就會互相打架。
所幸 jQuery 早就準備好了逃生門——jQuery.noConflict()。它的作用是把 $ 的控制權讓出去,交還給先佔用它的那個函式庫,此後我們改用 jQuery 這個名稱來操作 DOM 即可。以下用四種方式示範。
呼叫 noConflict() 之後,凡是原本寫 $ 的地方都改寫成 jQuery:
<script type="text/javascript">
jQuery.noConflict(); //將變量$的控制權讓渡給prototype.js
jQuery(function(){ //使用jQuery
jQuery("p").click(function(){
alert( jQuery(this).text() );
});
});
$("pp").style.display = 'none'; //使用prototype
</script>
如果嫌 jQuery 打起來太長,可以讓 noConflict() 回傳一個值,把它指派給自己喜歡的短變數:
<script type="text/javascript">
var $j = jQuery.noConflict(); //自定義一個比較短快捷方式
$j(function(){ //使用jQuery
$j("p").click(function(){
alert( $j(this).text() );
});
});
$("pp").style.display = 'none'; //使用prototype
</script>
在傳入 jQuery 的 ready 函式裡,把 $ 作為參數接收,這樣在函式內部 $ 依然代表 jQuery,外部則保留給 Prototype:
<script type="text/javascript">
jQuery.noConflict(); //將變量$的控制權讓渡給prototype.js
jQuery(function($){ //使用jQuery
$("p").click(function(){ //繼續使用 $ 方法
alert( $(this).text() );
});
});
$("pp").style.display = 'none'; //使用prototype
</script>
這是最乾淨的做法。定義一個以 $ 為參數的匿名函式,並立刻傳入 jQuery 執行,於是整個作用域內的 $ 都指向 jQuery,而全域的 $ 仍屬於 Prototype:
<script type="text/javascript">
jQuery.noConflict(); //將變量$的控制權讓渡給prototype.js
(function($){ //定義匿名函數並設置形參為$
$(function(){ //匿名函數內部的$均為jQuery
$("p").click(function(){ //繼續使用 $ 方法
alert($(this).text());
});
});
})(jQuery); //執行匿名函數且傳遞實參jQuery
$("pp").style.display = 'none'; //使用prototype
</script>
以上就是四種常見解法,原理都相同,可依團隊習慣挑一種採用。