維護老網站時,經常會遇到一個尷尬的處境:頁面已經依賴舊版 jQuery 與一堆外掛,若直接升級到新版,這些外掛很可能就掛了;可新寫的功能又想用新版。這時候,該如何讓多個 jQuery 版本在同一頁面上和平共處呢?
答案是 jQuery 的 noConflict()。
當我們引入 jQuery 時,它會往全域 window 注入兩個變數:
代碼如下:
window.$ = window.jQuery = { jQuery object };
同時,jQuery 內部會保留舊的 window.$ 與 window.jQuery 的引用。當我們呼叫:
代碼如下:
var $jq = $.noConflict();
window.$ 會被還原,但 window.jQuery 仍是 jQuery。若呼叫:
代碼如下:
var $jq = $.noConflict(true);
則 window.$ 與 window.jQuery 都會被還原,一切就像 jQuery 從未被引入過一樣,只能透過 $jq 這個變數來使用它。
所以,讓新舊版本共存可以這樣做:
代碼如下:
<script src="jquery-1.5.js"></script>
<script src="jquery-1.11.js"></script>
<script>
// 現在window.$和window.jQuery是1.11版本:
console.log($().jquery); // => '1.11.0'
var $jq = jQuery.noConflict(true);
// 現在window.$和window.jQuery被恢復成1.5版本:
console.log($().jquery); // => '1.5.0'
// 可以通過$jq訪問1.11版本的jQuery了
</script>
<script src="myscript.js"></script>
在 myscript.js 中,就能用 $jq 存取 1.11 版的 jQuery 了。
不過把兩個版本攤在頁面上,總顯得凌亂。萬一有人看不懂,把 noConflict 那行刪掉,或把兩行引入順序對調,最後拿到的版本就會出錯。更好的做法是:不改動頁面,直接引入我們自己寫的 js 檔:
代碼如下:
<script src="jquery-1.5.js"></script>
<script src="myscript.js"></script>
如此一來,我們在 myscript.js 內部引入新版 jQuery,而頁面本身有沒有 jQuery、是哪個版本,我們都不必理會。
先來把 myscript.js 的主體定下來:
代碼如下:
// myscript.js
(function () {
// BEGIN
// TODO: javascript code here...
// END
})();
用匿名函式包起來是個好習慣,不污染全域變數,也杜絕外部程式碼隨意存取。
下一步,直接把 jQuery 1.11 的程式碼嵌進去:
代碼如下:
// myscript.js
(function () {
// BEGIN
/*! jQuery v1.11.1 */
!function(a,b){"object"==typeof module&&"object"==typeof module.exports?...
if(k&&j[k]&&(e||j[k].data)||void 0!==d||"string"!=typeof b)return k||(k=...
},cur:function(){var a=Zb.propHooks[this.prop];return a&&a.get?a.get(thi...
var $ = jQuery.noConflict(true);
// TODO: javascript code here...
// END
})();
嵌入的是壓縮後的程式碼,大約三行,然後加上一句:
代碼如下:
var $ = jQuery.noConflict(true);
注意這裡的 $ 是一個區域變數,後續程式碼可以隨時引用它,跟頁面上其他版本 jQuery 的全域 $ 是不同物件,互不干擾。
最後一步,是確認 jQuery 的授權條款是否允許我們把它的原始碼直接嵌入自己的 JavaScript 檔中(jQuery 採用 MIT 授權,通常保留版權聲明即可)。
以上所述就是本文的全部內容了,希望大家能夠喜歡。