DIV CSS 佈局教程網

jQuery 版本升級踩坑大全:從 1.4.2 到 1.11.3
編輯:JQuery特效代碼     

jQuery 想必各位 Web 工程師都不陌生,但如今仍有不少網站採用較為古老的版本。由於早期版本若使用不當可能存在 DOM XSS 漏洞,非常建議升級到 jQuery 1.9.x 或以上版本。本文記錄了將項目 jQuery 從 1.4.2 升級到 1.11.3 過程中遇到的各類「坑」,並給出相應的解決方案。

一、坑從何處來

早期 jQuery 的很多寫法在新版本中已被廢棄,有些不規范的寫法舊版本尚能支持、新版本卻不再兼容;更棘手的是,有些寫法新版本仍支持,但行為已與從前不同,這類問題連報錯都不會有,需要深入代碼邏輯才能發現。

jQuery 官方推薦使用 jQuery Migrate 庫來輔助升級。開發中建議使用它的開發版,因為可以在瀏覽器控制台打印出不通過之處的詳細信息(壓縮版不會給出警告)。只需將 Migrate 庫緊跟在 jQuery 之後引用即可,待升級確認無誤後再去掉:

<script src="<path>/<to>/jquery-1.11.3.js"></script>
<script src="<path>/<to>/jquery-migrate-1.2.1.js"></script>

二、常見坑

1. 使用了被廢棄的 jQuery.fn.live 方法

警告:JQMIGRATE: jQuery.fn.live() is deprecated。live 用於事件代理,自 jQuery 1.7 起被 on 取代。注意不能簡單地將 live 換成 on,因為若 $(selector) 在當前頁面匹配不到元素就不會綁定成功,而 live 本質上是把事件代理到了必然存在的 document 上。正確替換方式為:

$(selector).live('click', function () { /* some code */ });
// 替換為
$(document).on('click', selector, function () { /* some code */ });

2. 使用了被廢棄的 jQuery.fn.die 方法

警告:JQMIGRATE: jQuery.fn.die() is deprecated。die 與 live 相反,用於取消事件綁定,新版本應使用 off 代替。

3. 使用了被廢棄的 jQuery.fn.toggle 函數

警告:JQMIGRATE: jQuery.fn.toggle(handler, handler...) is deprecated。用於綁定多個函數並在點擊時交替執行的 toggle 已被廢棄,可用一個帶 boolean 標志的 if-else 函數替代。

4. 使用了被廢棄的 jQuery.browser 屬性

警告:JQMIGRATE: jQuery.browser is deprecated。新版本建議改用特征檢測(如 Modernizr)。若想沿用具體判斷,可手動匹配 userAgent,例如判斷是否為 IE:/msie/.test(navigator.userAgent.toLowerCase())。

5. $(html) 格式書寫錯誤

相關警告有多種,例如 HTML 字符串必須以 '<' 開頭、標簽後不能有多餘文本、不能以 '#' 開頭等。這一點與低版本的 XSS 漏洞密切相關。以下寫法都是錯誤的:

$(" <div></div>");    // 錯誤:開頭有空格
$("#<div></div>");    // 錯誤:以井號開頭且後面並非選擇器,會被視為潛在 XSS 攻擊

6. jQuery.fn.attr 方法的錯誤使用(非常易犯)

獲取、設置 input 表單的值時,舊寫法 $('input').attr('value') 已不再正確,應改用:

$('input').val();            // 獲取輸入框的值
$('input').val('helloworld'); // 設置輸入框的值

設置單選框、複選框的選中狀態,以及 disabled、selected 等,應使用 prop 而非 attr:

$('input').prop('checked', true); // 設為選中
$('input').prop('checked');       // 獲取是否選中,返回 true/false

兩者的區別在於:prop 操作元素固有屬性,attr 操作寫在標簽上的自定義屬性。

7. 向 $.parseJSON 傳入了非法參數

警告:JQMIGRATE: jQuery.parseJSON requires a valid JSON string。常見於 AJAX 接收服務端返回值時,若服務端返回空字符串便會出錯。修正方式:

var v1 = $.parseJSON(str ? str : "null");

8. 使用了被廢棄的 'hover' 事件字符串

警告:JQMIGRATE: 'hover' pseudo-event is deprecated, use 'mouseenter mouseleave'。請用 'mouseenter mouseleave' 替換 'hover'。

9. jQuery.fn.andSelf 已被替換

警告:JQMIGRATE: jQuery.fn.andSelf() replaced by jQuery.fn.addBack()。兩者功能相同,直接替換即可。

三、少見坑

以下問題相對少見,但也值得留意:

  • 怪異模式:刪掉頁面頂部的 <!DOCTYPE html> 會觸發。正常開發中應始終保留 DOCTYPE。
  • AJAX 全局事件必須綁定到 document:從 jQuery 1.9 起,ajaxStart、ajaxStop、ajaxSend、ajaxComplete、ajaxError、ajaxSuccess 只能綁定到 $(document) 上。
  • IE6/7/8 不支持修改 input 的 type 屬性。
  • 移除了 $.clean、$.event.handle、$.attrFn 等內部方法:這些接口從未出現在官方文檔中,不建議使用。
  • 使用了過時的 $.sub() 方法:用於創建 jQuery 副本,自 1.7 起廢棄。
  • 使用了過時的 jQuery.fn.error 方法:可用 $(selector).on('error', function(){}) 替代。

四、示例代碼

為了直觀地觸發 jQuery Migrate 庫的所有警告,可以寫一段測試代碼,把各類「坑」都踩一遍。打開頁面後按 F12 打開控制台,即可看到完整的警告列表:

<!-- filename : index.html -->
<!--<!DOCTYPE html>--> <!-- keng0 怪異模式 -->
<html>
<head>
<meta charset="utf-8" />
<title>jQuery升級踩坑大全</title>
<script type="text/javascript" src="jquery-2.1.4.min.js"></script>
<script type="text/javascript" src="jquery-migrate-1.2.1.js"></script>
</head>
<body>
<div class="test" id="a">a</div>
<input type="radio" id="b" value="b" />
<input type="radio" id="c" value="c" />
<div id="d" value="d">test</div>
<script type="text/javascript">
// 使用被廢棄的 $.attrFn
var keng1 = $.attrFn || {};
// 在該使用 prop 的地方使用了 attr
var keng4 = $("input#c").attr("checked", true);
// 使用 attr 獲取 property 的值,正確應使用 .val()
var keng5 = $("div#d").attr("value");
// html 字符串必須以 '<' 開頭
var keng7 = $(" <div></div>");
// html 字符串不可以以井號開頭
try { var keng9 = $("#<div></div>"); } catch (e) { console.error(e); }
// $.parseJSON 的參數必須是合法的 JSON 字符串
var keng10 = $.parseJSON(undefined);
// 使用被廢棄的 $.browser
var keng11 = $.browser;
// 調用了已被 addBack 替換的 andSelf
var keng14 = $("#c").nextAll().andSelf();
// "hover" 字符串注冊事件已被拆分
var keng16 = $("#d").on("hover", function () {});
// 全局 AJAX 事件必須綁定到 document 對象上
var keng18 = $("#c").ajaxStart(function () {});
// 使用了被廢棄的 error 方法
var keng19 = $("#c").error(function () {});
// 使用了被廢棄的 toggle 方法
var keng20 = $("#d").toggle(function () {}, function () {});
// 使用了被廢棄的 live 方法,應使用 on 替代
var keng21 = $("#a").live("click", function () {});
// 使用了被廢棄的 die 方法,應使用 off 替代
var keng22 = $("#a").die("click");
</script>
</body>
</html>

以上便是 jQuery 升級過程中常見與少見的各類問題彙總。升級時善用 jQuery Migrate 的開發版,逐一排查控制台警告,就能讓老項目平穩地過渡到新版本。

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