長年是 jQuery 1.7.2 的專案要升級時,最容易踩到的不是 API 差異,而是那些「用得很順手但已被移除」的方法。它們不會在載入時報錯,只會在你操作到那顆按鈕時突然爆掉。
.live() → .on()(jQuery 1.9 起移除)。live 用於替未來才加入的元素掛事件,現在改用 $(document).on('click', '.selector', handler) 這種事件委派寫法。
.die() → .off()(1.9 起移除)。它是 live 的反向操作,對應的寫法是 $(document).off('click', '.selector', handler)。
.size() → .length(1.8 起移除)。$('.item').size() 改寫成 $('.item').length 即可,屬性比方法更快。
.toggle() → 官方無對應替代(1.8 起移除)。這是最麻煩的一個,因為 jQuery 官方沒有提供替代品。
原本 .toggle(fn1, fn2) 的功能是「每次點擊輪流執行不同函式」。移除後有兩條路:
如果你只是想切換樣式,用 .toggleClass(),這是最單純的情況。
如果你要切換行為,就自己維護一個旗標:
var i = 0;
$('#test').click(function(){
if (i == 0) { /* 執行方法 A */ i = 1; }
else { /* 執行方法 B */ i = 0; }
});
這個寫法雖然樸素,但行為明確、可讀性高,也不依賴任何特定版本。
先安裝 jQuery Migrate。這個官方外掛會在 console 中警告哪些方法已被棄用,並暫時補回部分舊 API,讓你能逐項修正而不必一次改完,是平滑升級最有效率的工具。
全專案搜尋關鍵字。把 live、die、size、toggle、bind、unbind、delegate、undelegate、load、unload、error 這些字串搜一輪,逐一確認。其中 .load()、.error() 這類與 AJAX 及事件同名的方法在 3.x 中也有變動。
注意 attr 與 prop 的分裂。這不算移除,卻是升級時最常出錯的地方:1.9 之後 .attr('checked') 不再回傳布林狀態,必須改用 .prop()。
最後,如果專案還有大量舊寫法,先想清楚是否真的需要升級。若只是為了新功能而升,成本可能高於收益;若是為了安全性與維護性,那麼搭配 Migrate 分階段進行會是最穩健的路。