DIV CSS 佈局教程網

jQuery 升級到 1.9 以上實戰:踩過的坑與解法
編輯:JQuery常見問題     

jQuery 1.9.0 大概是在 1 月 15 日發布的。消息一出,社群上就有人說這次升級會「死掉大批插件」——因為它移除了很多常用 API。糾結了好一陣,最後還是決定把站點的 jQuery 升到 1.9.1。

路線一:靠官方 migrate 插件無縫過渡

官方大概也知道這次改動幅度大,特別提供了文件與插件協助推進升級。這個插件把「偵測」與「相容」打包在一起:只要把 jQuery 升到 1.9.1,然後在其後引入 jquery-migrate,就能最省事地跑起來。插件會把現有程式碼中用到已移除 API 的地方,以警告形式印在 console 上,一目了然。

不得不說這是相當有溫度的做法,很多國內開源專案反而做不到這種細節。

路線二:不引入插件,照升級指南逐項改造

但有時候你就是不想多載一支腳本。那就只能照 jQuery 提供的升級指南,把每個改動過的 API 逐一改掉。以下是我自己實際碰到的問題:

1. attr → prop

讀寫 checked、readonly、selected 這類「狀態屬性」時,請改用 prop:

$('checkbox').attr('checked', 'checked');  //不推薦
$('checkbox').prop('checked', true);       //推薦

2. hover → mouseenter / mouseleave

官方把 hover 拿掉了,建議改成:

$('body').on({ 'mouseenter': fn1, 'mouseleave': fn2 });

3. toggle(fn, fn, ...)

這裡指的是「傳入多個函數輪流切換」的那個 toggle,不是控制隱藏顯示的 toggle。它沒有直接替代,需要依自己的條件邏輯改寫。

4. $.browser()

已被完全移除。改用第三方偵測庫(推薦 Modernizr,除了瀏覽器還能偵測特性),或直接讀 navigator.userAgent。不想引入整個庫可以按需下載部分原始碼:https://modernizr.com/download/

5. live / die → on / off

把原始碼裡的 live 直接換成 on 即可。

6. $(html) 必須以 < 開頭

否則會報錯。最怕的是字串前面不小心有空白,我的解法是先 $.trim() 處理一次。

7. Ajax 事件只能綁在 document 上

$("#status").ajaxStart(function(){ $(this).text("Ajax started"); });  //舊
$(document).ajaxStart(function(){ $("#status").text("Ajax started"); });  //新

官方升級指引沒提到的兩個坑

從 1.7.1 升到 1.9.1 時,還踩到兩個不在文件裡的變化:

data() 在節點不存在時的返回值:取一個不存在節點的 data 值,1.7 回傳 undefined,1.9.1 回傳 null。假設頁面上沒有 id 為 none 的節點:

$('#none').data('anyKey');  //1.9.1 回傳 null

所以不能只用 typeof $('#none').data('anyKey') == 'undefined' 來判斷。

$.parseJSON 對空字串的容忍度:若後端意外回傳一個空字串(正常情況下像 PHP 的 json_encode() 都會處理好,但總有意外),1.9.1 會直接拋錯:

$.parseJSON('');  //SyntaxError: JSON.parse: unexpected end of data

1.9.1 之前不會報錯,看來容錯得自己做。解法是送出前先擋掉空值,例如 $.parseJSON('{}');。

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