為了兼顧舊版瀏覽器,不少專案長期停留在 jQuery 1.7.2。然而隨著瀏覽器版本快速更迭、前端工具鏈持續演進,就連 Bootstrap 新版本都要求搭配 jQuery 1.9 以上,1.7.2 這位老將也該光榮退場了。
真正的麻煩在於:升級之後,我們日常寫習慣的一部分函式已被標記為廢棄(deprecated)。若沒有留意,執行時就會拋出各種錯誤。以下就來盤點這些已被淘汰的函式,以及對應的替代寫法。
如果你從沒聽過下面這些被廢棄的函式,那恭喜你,完全不必去背——只要理解替代方案即可。這篇文章的價值,在於提醒升級 jQuery 時該避開哪些「地雷」,以及該改用什麼。
.on()過去我們用 .live() 替「未來才加入 DOM 的元素」綁定事件,如今統一改用 .on() 的事件委派寫法,在父元素上監聽即可。
.off()它是 .live() 的反操作,用於解除事件綁定,現在同樣由 .off() 接手。
.length 屬性取得集合中元素數量時,改用 $('selector').length 即可,語意更直接,也少一次函式呼叫。
這個最麻煩,所以留到最後談。官方並沒有給出一對一的替代品,但這難不倒工程師,可依用途分兩路處理:
若是切換 CSS 樣式,改用 .toggleClass():
$('#test').toggleClass('active');
若是要輪流切換不同行為,用一個狀態變數自行實作即可:
var i = 0;
$('#test').click(function () {
if (i === 0) {
// 第一次點擊要執行的內容
i = 1;
} else {
// 第二次及之後要執行的內容
i = 0;
}
});
小結:升級 jQuery 時,先把專案裡的 .live()、.die()、.size()、.toggle() 全域搜一遍,逐一替換,多數錯誤就能提前化解。