維護老專案時常遇到這種尷尬:頁面主程式依賴 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 了。
插件檔案的開頭加上:
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) 即可。不論來幾個版本,衝突問題都能收斂。
當然,更根本的解法是逐步把舊程式遷移到單一版本上——多版本共存始終是技術債,能撐過一時,但每一次升級都得重跑一輪。