编辑注:jQuery3.0即将发布,来看看这篇jQuery 3 升级指南,介绍了jQuery3有哪些改进与删除,即使你的网站因为要照顾 IE8 而不能升级,那也可以看看这个最流行的前端开源项目是如何演进的。
jQuery 的横空出世,至今已有十个年头了,而它的长盛不衰显然不是没有理由的。jQuery 提供了极为友好的接口,使得开发者们可以方便地进行 DOM 操作、发起 Ajax 请求、生成动画……不一而足。此外,与 DOM API 不同的是,jQuery 采用了 “混合模式”。这意味着你可以在任何一个 jQuery 集合身上调用 jQuery 方法,而不用关心它到底包含了几个元素(不管是零个、一个或多个,都没问题)。
在未来的几周内,jQuery 就将抵达一个重要的里程碑——正式发布 3.0 版本。jQuery 3 修复了大量的 bug,增加了新的方法,同时移除了一些接口,并修改了少量接口的行为。在这篇文章中,我将为大家重点讲解 jQuery 3 所引入的那些最重要的变化。
新增特性
我们先来讨论 jQuery 3 中最重要的几个新增特性。
for...of
循环
在 jQuery 3 中,我们可以用 for...of
循环语句来迭代一个 jQuery 集合中的所有 DOM 元素。这种新的迭代方法是 ECMAScript 2015(即 ES6)规范中的一部分。这个方法可以对 “可迭代对象”(比如 Array
、Map
、Set
等)进行循环。
当使用这种新的迭代方法时,你在循环体内每次拿到的值并不是一个 jQuery 对象,而是一个 DOM 元素(译注:这一点跟 .each()
方法类似)。当你在对一个 jQuery 集合进行操作时,这个新的迭代方法可以少许改善你的代码。
为了搞清楚这种迭代方法到底是怎么工作的,我们来假设一个场景——你需要给页面中的每个 input
元素分配一个 ID。在 jQuery 3 之前,你可能会这样写:
var $inputs = $('input');for(var i = 0; i < $inputs.length; i++) {
$inputs[i].id = 'input-' + i;
}
而在 jQuery 3 中,你就可以这样写了:
var $inputs = $('input');var i = 0;
for(var input of $inputs) {
input.id = 'input-' + i++;
}
(译注:其实 jQuery 自己是有个 .each()
方法的,可读性也不赖。)
$.get()
和 $.post()
函数的新签名
jQuery 3 为 $.get()
和 $.post()
这两个工具函数增加了新签名,从而使得它们和 $.ajax()
的接口风格保持一致。新签名是这样的:
$.get([settings])
$.post([settings])
settings
是一个对象,它包含多个属性。它的格式和你以前传给 $.ajax()
的参数格式是一样的。如果你想更清楚地了解这个参数对象,请参考 $.ajax()
页面 中的相关描述。
$.get()
和 $.post()
的参数对象与传给 $.ajax()
的参数相比,唯一的区别就是前者的 method
属性总是会被忽略。原因其实也很简单,$.get()
和 $.post()
本身就已经预设了发起 Ajax 请求的 HTTP 方法了(显然 $.get()
就是 GET,而 $.post()
就是 POST)。也就是说,正常人类应该是不会想用 $.get()
方法来发送一个 POST 请求的。
假设有以下一段代码:
$.get({
url: 'https://www.audero.it',
method: 'POST' // This property is ignored
// 这个属性将被忽略});
不管我们把 method
属性写成什么,这个请求总是会以 GET 的方式发出去的。
采用 requestAnimationFrame()
来实现动画
所有现代浏览器(包括 IE10 及以上)都是支持 requestAnimationFrame
的。jQuery 3 将会在内部采用这个 API 来实现动画,以便达到更流畅、更省资源的动画效果。
unwrap()
方法
jQuery 3 为 unwrap()
方法增加了一个可选的 selector 参数。这个方法的新签名是这样的:
unwrap([selector])
有了这个特性,你就可以给这个方法传入一个包含选择符表达式的字符串,用它来在父元素内进行匹配。如果存在匹配的子元素,则这个子元素的父层将被解除;如果没有匹配,则不进行操作。
有变更的特性
jQuery 3 还修改了一些特性的行为。
:visible
和 :hidden
jQuery 3 将会修改 :visible
和 :hidden
过滤器的含义。只要元素具有任何布局盒,哪怕宽高为零,也会被认为是 :visible
。举个例子,br
元素和不包含内容的行内元素现在都会被 :visible
这个过滤器选中。
因此,如果你的页面中包含如下的结构:
<div></div><br />
然后运行以下语句:
console.log($('body :visible').length);
在 jQuery 1.x 和 2.x 中,你得到的结果会是 0
;但在 jQuery 3 中,你会得到 2
。
data()
方法
另一个重要的变化是跟 data()
方法有关的。现在它的行为已经变得跟 Dataset API 规范 一致了。jQuery 3 将会把所有属性键名转换成驼峰形式。我们来详细看一下,以如下元素为例:
<div id="container"></div>
当我们在用 jQuery 3 以前的版本时,如果运行如下代码:
var $elem = $('#container');
$elem.data({ 'my-property': 'hello'});console.log($elem.data());
将会在控制台得到如下结果:
{my-property: "hello"}
而在 jQuery 3 中,我们将会得到如下结果:
{myProperty: "hello"}
请注意,在 jQuery 3 中,属性名已经变成了驼峰形式,横杠已经被去除了;而在以前的版本中,属性名会保持全小写,并原样保留横杠。
Deferred
对象
jQuery 3 还改变了 Deferred
对象的行为。Deferred
对象可以说是 Promise
对象的前身之一,它实现了对 Promise/A+ 协议 的兼容。这个对象以及它的历史都相当有意思。如果想要深入了解,你可以去阅读 jQuery 官方文档,也可以去看我写的书《jQuery 实战(第三版)》——这本书也涵盖了 jQuery 3。
在 jQuery 1.x 和 2.x 中,传给 Deferred
的回调函数内如果出现未捕获的异常,会立即中断程序的执行(译注:即静默失败,其实 jQuery 绝大多数回调函数的行为都是这样的)。而原生的 Promise
对象并非如此,它会抛出异常,并不断向上冒泡,直至到达 window.onerror
(通常冒泡的终点是这里)。如果你没有定义一个函数来处理这个错误事件的话(通常我们都不会这么做),那这个异常的信息将会被显示出来,此时程序的执行才会停止。
jQuery 3 将会遵循原生 Promise
对象的模式。因此,回调内产生的异常将会导致失败状态(rejection),并触发失败回调。一旦失败回调执行完毕,整个进程就将继续推进,后续的成功回调将被执行。
为了让你更好地理解这个差异,让我们来看一个小例子。比如我们有如下代码:
var deferred = $.Deferred();
deferred
.then(function() { throw new Error('An error');
})
.then( function() { console.log('Success 1');
}, function() { console.log('Failure 1');
}
)
.then( function() { console.log('Success 2');
}, function() { console.log('Failure 2');
}
);
deferred.resolve();
在 jQuery 1.x 和 2.x 中,只有第一个函数(也就是抛出错误的那个函数)会被执行到。此外,由于我们没有为 window.onerror
定义任何事件处理函数,控制台将会输出 “Uncaught Error: An error”,而且程序的执行将中止。
而在 jQuery 3 中,整个行为是完全不同的。你将在控制台中看到 “Failure 1” 和 “Success 2” 两条消息。那个异常将会被第一个失败回调处理,并且,一旦异常得到处理,那么后续的成功回调将被调用。
SVG 文档
没有哪一个 jQuery 版本(包括 jQuery 3)曾官方宣称支持 SVG 文档。不过事实上有很多方法是可以奏效的,此外还有一些方法在以前是不行的(比如操作类名的那些方法),但它们在 jQuery 3 中也得到了更新。因此,在 jQuery 3 中,你应该可以放心使用诸如 addClass()
和 hasClass()
这样的方法来操作 SVG 文档了。
已废弃、已移除的方法和属性
在增加了上述改进的同时,jQuery 也移除、废弃了一些特性。
废弃 bind()
、unbind()
、delegate()
和 undelegate()
方法
jQuery 在很久以前就引入了 on()
方法,它提供了一个统一的接口,用以取代 bind()
、delegate()
和 live()
等方法。与此同时,jQuery 还引入了 off()
这个方法来取代 unbind()
、undelegated()
和 die()
等方法。从那时起,bind()
、delegate()
、unbind()
和 undelegate()
就已经不再推荐使用了,但它们还是一直存在着。
jQuery 3 终于开始将这些方法标记为 “废弃” 了,并计划在未来的某个版本(很可能是 jQuery 4)中将它们彻底移除。因此,请在你的项目中统一使用 on()
和 off()
方法,这样你就不用担心未来版本的变更了。
移除 load()
、unload()
和 error()
方法
jQuery 3 彻底抛弃了 load()
、unload()
和 error()
等已经标记为废弃的方法。这些方法在很早以前(从 jQuery 1.8 开始)就已经被标记为废弃了,但一直没有去掉。如果你正在使用的某款插件仍然依赖这些方法,那么升级到 jQuery 3 会把你的代码搞挂。因此,在升级过程中请务必留意。
移除 context
、support
和 selector
属性
jQuery 3 彻底抛弃了 context
、support
和 selector
等已经标记为废弃的属性。同上,在升级到 jQuery 3 时,请留意你正使用的插件。
已修复的 Bug
jQuery 3 修复了以往版本中的一些非常重要的 bug。在本节中,我将着重介绍其中两处,因为这两者应该会对你写代码的习惯带来显著影响。
width()
和 height()
的返回值将不再取整
jQuery 3 修复了 width()
、height()
和其它相关方法的一个 bug。这些方法的返回值将不再舍入取整,因为这种取整行为在某些情况下不便于对元素进行定位。
我们来详细看一看。假设你一个宽度为 100px
的容器元素,它包含了三个子元素,宽度均为三分之一(即 33.333333%):
<div class="container">
<div>My name</div>
<div>is</div>
<div>Aurelio De Rosa</div></div>
在 jQuery 3 以前的版本中,如果你尝试通过以下代码来获取子元素的宽度……
$('.container div').width();
……那么你得到结果将是 33
。原因在于 jQuery 会把 33.33333 这个值取整。而在 jQuery 3 中,这个 bug 已经被修复了,因此你将会得到更加精确的结果(即一个浮点数)。
wrapAll()
方法
jQuery 3 还修复了 wrapAll()
方法中的一个 bug,这个 bug 出现在把一个函数作为参数传给它的情况下。在 jQuery 3 以前的版本中,当一个函数被传给 wrapAll()
方法时,它会把 jQuery 集合中的每个元素单独包裹起来。换句话说,这种行为和把一个函数传给 wrap()
时的行为是完全一样的。
在修复这个问题的同时,还引入了另外一个变更:由于在 jQuery 3 中,这个函数只会调用一次了,那就无法把 jQuery 集合中每个元素都传给它。因此,这个函数的执行上下文(this
)将只能指向当前 jQuery 集合中的第一个元素。
如何下载 jQuery 3 beta 1
既然你已经读到了这里,那说明你很可能想试试 jQuery 3 的第一个 beta 测试版。你可以通过以下两个地址来获取这个版本:
- 未压缩版: https://code.jquery.com/jquery-3.0.0-beta1.js
- 压缩版: https://code.jquery.com/jquery-3.0.0-beta1.min.js
当然,你还可以通过 npm 来下载:
npm install jquery@3.0.0-beta1
结论
很多人一直在唱衰 jQuery,说它在现代网页开发中已经没有一席之地了。但不管怎样,jQuery 的开发仍在继续,客观的统计数据(在排名前一百万名的网站中占有率高达 78.5%)也让这些论调不攻自破。
在本文中,我已经带你了解了一遍 jQuery 3 将会带来的一些重大变化。或许你已经察觉到了,这个版本并不太可能搞挂你的既有项目,因为它引入的破坏性变更其实寥寥无几。不过,在升级到 jQuery 3 的过程中,你还是有必要牢记一些关键点,比如 Deferred
对象的改进等等。同样,在升级某个第三方库时,也有必要检查一下该项目的兼容性情况,以便尽早发现任何非预期行为,避免某些功能失效。
译注
除了本文所提及的变更之外,jQuery 3.0 最大的变化就是彻底放弃对 IE8 的支持。jQuery 团队做出这个决定的原因在于,微软已经在今年年初宣布停止对 IE 8~10 的支持。因此,jQuery 在 3.0 alpha 阶段所发布的 jQuery Compat 项目也就没有继续存在的必要了。
不过,由于 IE8 仍然是中国大陆最流行的浏览器之一,对国内的开发者来说,在短期(甚至中期)内还不得不停留在 jQuery 1.x 版本。
好吧,最后还是说个好消息吧。为帮助用户平滑升级,此次 jQuery 同样会为 3.0 版本提供迁移插件(jQuery Migrate plugin)。在把 jQuery 升级到 3.0 之后同时运行这个插件,即可确保基于 jQuery 1.x 或 2.x 的既有业务代码正常运行;同时,它还将在控制台向你报告既有代码与 jQuery 3 不兼容的地方。当你修复了这些不兼容问题之后,就可以安全地移除这个插件了。