DIV CSS 佈局教程網

多版本 jQuery 共存衝突的完整解法(noConflict 應用)
編輯:JQuery特效代碼     

維護老專案時常遇到這種尷尬:頁面主程式依賴 jQuery 1.3.2,而某個新插件非 1.4.2 以上不能用,兩支一起載入就互相搶 $ 的控制權,最後誰也跑不動。以下是以 1.3.2 與 1.4.2 共存為例的完整做法(實測可行)。

第一步:讓新版主動交出控制權

在 1.4.2 的原始碼最末尾加上:

var $j4 = jQuery.noConflict(true);

把這句寫在源碼裡、而不是等到呼叫時才寫,是因為基於 1.4.2 的插件往往有很多個,若每個插件都要補一次就會不斷重複。這行的作用其實就是源碼裡的這兩句:

window.$ = _$;
window.jQuery = _jQuery;

也就是把先前暂存的引用還回去,同時把 1.4.2 的 $ 與 jQuery 引用權全部放棄,改掛在 $j4 這個新命名空間上(它是 window 的屬性)。此後基於 1.4.2 的插件就不能再用 $ 或 jQuery 了。

第二步:在每個 1.4.2 插件的前後包夾

插件檔案的開頭加上:

var _temp$ = window.$, _tempjQuery = window.jQuery;
window.$ = $j4;
window.jQuery = $j4;

先把 1.3.2 的 $ 與 jQuery 暫存到臨時變數,再把全域指向 1.4.2,這樣中間那些完全不打算修改的原始碼就能正常運作。

插件檔案的結尾加上:

window.$ = _temp$;        // 把 $ 的引用權還給 1.3.2
window.jQuery = _tempjQuery;

為什麼非得用臨時變數暫存?

其一,不想大改插件源碼。只在頭尾加幾行、中間一行不動,是最省成本也最不容易出錯的改法。

其二,插件必然要用 $ 或 jQuery。1.4.2 已經放棄了這兩個名稱的控制權,但既有的插件程式碼仍然照用,因為插件作者不可能預期你會有版本衝突。

其三,防止插件內部直接呼叫 window.$。這種寫法雖然少見,但一旦出現就會抓到 1.3.2 的版本,前述包夾正好把它擋掉。

第三步:約定呼叫方式

之後凡是需要用到 1.4.2 的功能,一律寫成 $j4(element);1.3.2 則維持 $(element) 不變。

歸納與延伸

這套方案的分工是:1.4.2 完全放棄 $ 與 jQuery;1.3.2 放棄 $ 的控制權但保留 jQuery(也可一併放棄,另取別名 $j3)。若專案裡還有用到 prototype,最好把它排在 1.3.2 之後,由它接手 $。

假如又冒出一個 jQuery 1.2,做法完全一樣,只要把第一步改為 var $j2 = jQuery.noConflict(true);,第三步改用 $j2(element) 即可。不論來幾個版本,衝突問題都能收斂。

當然,更根本的解法是逐步把舊程式遷移到單一版本上——多版本共存始終是技術債,能撐過一時,但每一次升級都得重跑一輪。

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