jQuery 1.8 发布

---

八月变得更加火热，因为 jQuery 1.8 最终代码已经发布！您可以在 jQuery 的 CDN 上获取代码

• https://code.jqueryjs.cn/jquery-1.8.0.min.js（压缩和最小化，用于生产）
• https://code.jqueryjs.cn/jquery-1.8.0.js（未压缩，用于调试）

与往常一样，Google 和 Microsoft CDN 也将很快拥有该文件。请不要问我们什么时候会出现在那里，我们不知道，我们也不控制那些 CDN！如果您迫不及待地想要开始使用，请直接使用上面 jQuery CDN 中的副本。它们是相同的位。

我们预计不会收到关于此版本的任何错误报告，因为已经发布了几个测试版和一个候选版本，每个人都有充分的机会进行彻底测试。哈哈，这个笑话永远不会过时。我们知道你们中的太多人会在用代码尝试它之前等待最终版本。所以现在真的没有理由等待，您可以找出是否有您之前可以报告的任何错误。

如果您发现错误，请在 jsFiddle 或 jsbin 上创建一个测试用例，并在我们的 错误跟踪器 上提交错误。如果您不确定是否发现了错误，请在我们的 论坛 上询问。jQuery 核心 1.8.0 与最新版本的 jQuery UI (1.8.22) 和 jQuery Mobile (1.1.1) 兼容。如果您在涉及这些内容的页面上报告错误，请确保更新它们。

jQuery 1.8 的快速浏览

让我们回顾一下此版本中的重大变化

Sizzle 架构重新设计： 由于 Timmy Willison 的重写（实际上是两次重写），jQuery 的选择器引擎比以往任何时候都快。当然，大多数浏览器现在都具有 querySelectorAll，但几乎每种实现都在某种程度上存在不足，导致一路充满跨浏览器漏洞。Sizzle 为您平整了这条道路。此外，您可能希望使用那些有用的 jQuery 选择器扩展，例如具有复杂选择器的 :has() 或 :contains()。哦，对了，它仍然支持 IE6/7。

动画重新构想： 随着时间的推移，jQuery 中的动画代码变得有点混乱。Corey Frang 毅然决然地跳入这个沼泽，设法移除了大多数鳄鱼，嗯，错误。大多数更改是在幕后进行的，因此现有的动画应该仍然有效（并且工作得更好）。但它也有一些很棒的补充，使动画更加通用和可扩展。一个值得注意且非常酷的功能是使用 Promise 中的进度回调。我们仍在努力编写详细的文档，但我们确实有一个 草案。此外，这里有一个新代码运行的示例：http://jsbin.com/odocid/1/edit。

自动 CSS 前缀： 当您在 .css() 或 .animate() 中使用 CSS 属性时，我们将使用针对该浏览器的正确带前缀属性（在适当的情况下）。例如，以 .css("user-select", "none") 为例；在 Chrome/Safari 中，我们将该值设置为 "-webkit-user-select"，Firefox 将使用 "-moz-user-select"，而 IE10 将使用 "-ms-user-select"。

$(html, props) 更加灵活： 在 jQuery 1.8 中，您可以在传递给 $(html, props) 的对象中使用任何 jQuery 方法或插件。以前，您只能使用一小部分方法名，而且没有记录的方法来添加更多方法名。现在根本不需要列表！但是请注意，如果后来添加了与 HTML 属性同名的插件，这可能会导致代码行为发生改变。

修复了超过 160 个错误： 特别是 Sizzle 和动画重写推动了几个长期存在的错误的修复——其中一些错误已经存在两三年了。Mike Sherov 解决了许多未解决的 CSS 和定位问题，使我们在那里的错误数量降至接近零。我们也并没有放弃，仍然在努力消除 IE 6/7/8 和现代浏览器之间烦人的差异，因此您不必处理这些差异。

更小的代码大小： 尽管进行了所有代码清理、新功能和错误修复，但 jQuery 1.8 的压缩文件大小实际上比 jQuery 1.7.2 小了几百字节。缩减大小并不是我们在这个版本中的主要目标，但我们觉得控制代码增长很重要，而我们确实做到了这一点。非常感谢 Richard Gibson 在整个项目中领导了代码压缩工作。

模块化： 如果您了解项目的 jQuery 依赖项，可以使用新的基于 grunt 的构建系统来剥离您知道不需要的 jQuery 部分。我们在 1.8 中所做的事情只是一个开始，在未来的版本中您将看到更多灵活性。

如果您想知道您最喜欢的错误是否已修复，完整的更改日志如下所示。

已删除的内容

简而言之，“很少”。我们希望为将在 1.9 中删除的弃用功能提供充足的通知时间，以便人们有时间调整代码。在 1.8 中删除的几个内容是未记录的内部内容，有些人巧妙地对其进行了反向工程，但使用未记录的功能始终存在风险。以下是已删除的项目

$(element).data(“events”)：在 1.6 版本中，jQuery 将其内部数据与用户的内部数据分开，以防止名称冲突。但是，有些人一直在使用未记录的内部“events”数据结构，因此我们使其仍然可以通过 .data() 检索。现在，它在 1.8 中已删除，但您仍然可以通过 $._data(element, "events") 获取用于调试目的的事件数据。请注意，这不是受支持的公共接口；实际数据结构可能会在不同版本之间发生不兼容的改变。

Deferred.isResolved() 和 Deferred.isRejected()：调用 N-1 个布尔方法来获取 N 状态变量的状态有点愚蠢，因此我们在 jQuery 1.7 中添加了 Deferred.state()，以便您在一次调用中告诉您状态。因此，这两个较旧的方法不再需要。对于经常需要以字符串形式了解 Deferred 状态的调试场景而言，这更加方便。

$(element).closest(Array) 返回 Array：这是 .closest() 方法的奇怪签名，旨在供旧的 .live() 使用，但据我们所知，没有其他代码使用它。删除此签名不会影响 .closest() 返回 jQuery 对象的正常用法。

$.curCSS：该方法从 jQuery 1.3 开始只是 jQuery.css() 的别名。尽管它从未成为记录的 API 的一部分，但已知某些外部代码使用它，可能认为它“更高效”。现在它“更消失了”。

$.attrFn：另一个未记录的项目，用于定义哪些方法可以与 $(html, props) 签名一起使用。尽管它在 jQuery 1.8 中没有发挥任何功能作用，但我们会在 jQuery 中保留一个空 $.attrFn，以防止使用它的代码抛出错误。警告：此项将在 jQuery 1.9 中完全删除，因此请更新您的代码！

功劳归谁

如果没有才华横溢的 jQuery 核心团队的辛勤工作，这个版本不可能发布：Julian Aubourg (jaubourg)、Corey Frang (gnarf)、Richard Gibson (gibson042)、Mike Sherov (mikesherov)、Rick Waldron (rwaldron) 和 Timmy Willison (timmywil)。

特别感谢在 jQuery 1.8 开发周期中通过修补贡献来支持核心团队的 jQuery 团队和社区成员：Andy Monat、Robert Katic、Joaoh Bruni、Sindre Sorhus、Oleg Gaidarenko、Yehuda Katz、Timo Tijhof、Dominik D. Geyer、Scott González、Jörn Zaefferer、Matt Farmer、Trey Hunner、Jason Moon、Ben Alman、Jeffery To、Kris Borchers、Daniel Herman、Vladimir Zhuravlev、Jacob Thornton、Chad Killingsworth、Nowres Rafid、David Benjamin、Uri Gilad、Chris Faulkner、Elijah Manor 和 Daniel Chatfield。

我们也对那些抽出时间报告错误的人表示感谢；如果没有知道错误的存在，我们就无法修复它。如果您想为 jQuery 做贡献，请了解 错误跟踪器，并通过创建清楚地展示错误的缩减测试用例来帮助我们。一旦我们能够重现问题，解决方案通常就不远了。这些测试用例将成为单元测试的基础，可以防止我们在以后的版本中更改代码时出现此问题。

jQuery 1.8 更改日志

Ajax

• #8205：JSONP 随机结果在 IE8 中会导致内存泄漏
• #8653：jQuery.param 在查询字符串中输出“null”和“undefined”
• #9399：弃用 jqXHR.success 和 jqXHR.error
• #10285：evalScript rcleanScript 替换在 IE8 中失败
• #10524：jQuery.fn.load 不会将数据参数与 jQuery.ajaxSetup 合并
• #10944：$.ajax 并不总是返回实现 Promise 接口的对象
• #11013：弃用 Deferred/Promise 与同步 $.ajax 的使用
• #11402：evalScript 函数在 IE 中出现错误 80020101 时失败
• #11743：jQuery 在 $.appendTo() 中的脚本标签 ajax 请求期间静默忽略错误
• #11778：缓存的 XHR 请求仍然应该异步解析
• #12122：jQuery.ajax() 异步弃用与 $.Deferred 的使用

属性

• #11153：jQuery 1.7 在 IE 8 中剥离了回车符
• #11212：Sizzle.getText 在 IE 上将不可分割的空间转换为空格
• #11547：XML DOM .removeAttr() 不会删除带大小写的属性
• #11962：标准化空集的 getter 返回值。
• #12127：克隆在 IE10 中没有正确复制选中状态

构建

• #11767：支持没有效果的自定义构建
• #11789：更新 README 以描述 grunt 构建系统
• #11856：模块化尺寸
• #11857：模块化 css
• #11865：模块化偏移量
• #11965：创建 deprecated.js 以包含尽可能多的弃用内容
• #12059：`grunt custom` 应该最小化——还应该将排除的模块添加到标题中
• #12158: jQuery 1.8rc1 不兼容 YUICompressor 1.4.7

核心

• #10657: 弃用 jQuery#size()，改用 jQuery#length
• #11290: 选择器被解释为 HTML
• #11470: 添加内置 readyP promise
• #12018: $(document).ready() 在 IE8 中过早触发
• #12026: 让 $(html, props) 使用任何 jQuery.fn 方法

CSS

• #10373: `document.defaultView` => `window`
• #10394: jQuery.cssHooks.opacity 在非 IE 浏览器中抛出异常
• #10413: 对于隐藏父元素的“box-sizing: border-box”子元素，width、innerWidth、innerHeight、outerWidth、outerHeight 不准确
• #10679: CSS3 供应商前缀支持
• #11004: 当 box-sizing 为 border-box 时，getWH 错误地删除了填充和边框宽度
• #11787: 删除 jQuery.curCSS
• #12088: Webkit 现在为更多 getComputedStyle 属性返回百分比
• #12148: 切换时，hide 事件不触发

数据

• #7579: jQuery.data() 会截断从 data-xxx 属性中获取的数字
• #10589: 删除 $.fn.data("events")
• #11435: 删除 .data 的返回值中的 toJSON 的过时测试代码

延迟

• #11010: 使 Deferred.then == Deferred.pipe 像 Promise/A 一样
• #11011: 允许为 $.Callbacks 标志使用传统的选项对象
• #11736: 删除 Deferred .isResolved() 和 .isRejected()
• #11749: 当多个 Deferred 对象传递给 $.when() 时，保留上下文对象

尺寸

• #6724: 移动 Safari (iPhone) 中的 $(window).height() 错误
• #10877: 使 outerWidth/Height 成为 setter
• #11293: 读取空 TD 的宽度或 outerWidth 会更改列宽度值
• #11604: 将 $(elem).width(-val) 从 no-op 更改为 $(elem).width(0)
• #11724: Firefox 12 中 $(document).height() 发生变化

效果

• #7109: 在 Webkit 中，animate 宽度以无效宽度开始
• #7157: 动画回调显示元素仍然是“:animated”
• #8387: 在 Webkit 浏览器中，jQuery 1.5 hide/show 与内联和内联块元素存在闪烁问题
• #8627: .animate() 在 IE 中的 letterSpacing 失败（1.5.1 中的回归）
• #8892: 在 fadeIn() 和 jQuery.fx.off = true 的情况下，回调在对象显示之前被调用
• #9217: 在 IE8 中，当动画元素在动画完成之前被删除时，出现 JavaScript 错误
• #9505: 在 WebKit 中混合使用百分比和像素时，animate() 出现问题
• #11635: 明确的 overflow:auto 在动画期间被内联 overflow:hidden 覆盖
• #11755: animate 及其别名不应使用 :hidden 选择器
• #11797: 新的与动画相关的事件
• #11854: 百分比动画跳到末尾
• #11971: 在 IE8 中，动画 background-position 失败
• #11999: 在 Chrome 中，固定 div 的增量动画执行减法而不是加法。
• #12117: 动画到 0 高度或宽度时，overflow hidden 设置不正确
• #12138: 在 Chrome 上，fadeOut 不适用于基本 SVG 元素
• #12150: 显示和隐藏行时，border-spacing 属性累积

事件

• #8545: IE 中的事件存在泄漏
• #10067: 在 document.readyState === 'interactive' 时也触发 $.ready
• #10895: bindReady 中的 doScrollCheck ie hack 无缘无故地降低了 ie7 性能
• #11101: 弃用 trigger 方法中的“exclusive”事件选项
• #11315: delegate() 和 :first 在具有相同类别的嵌套元素中存在问题
• #11328: Ctrl 键在 Windows 上不会将 event.metaKey 设置为 true
• #11382: Mouseenter 不会在禁用的输入元素上触发
• #11500: 错误：在 IE7 和 IE8 中，手动触发时，“change”事件处理程序不会执行
• #11621: 在文档上触发事件不会冒泡到窗口
• #11718: 弃用 .data() 事件
• #11719: 弃用 .bind("ready") 事件
• #11731: 弃用“hover”伪事件
• #11733: 弃用 .load()、.unload() 和 .error() 方法
• #11764: 允许在禁用的元素上委托非原生事件
• #11786: 弃用 .toggle( handler, handler, … ) 签名
• #12203: .undelegate() 不带参数会解除父元素的所有处理程序绑定

操作

• #8894: 在 IE 中，clone() 之后调用 appendTo() 等方法会在返回的 jQuery 集中返回不正确的值
• #10324: 在 IE9 中，Clone 不会复制对象元素的 innerHTML
• #11231: Append、Prepend、After、Before 应该接受数组作为第一个参数
• #11325: 改善 domManip/buildFragment/clean
• #11338: .replaceWith() 和断开连接的节点的行为不一致。
• #11528: IE8 序列化错误，.html() 也影响 html5 标签
• #11566: 当节点是 DocumentFragment 时，node.append 等不起作用
• #11617: 定义 $.parseHTML 方法来创建 HTML 片段
• #11809: .text(val) setter 中存在内存泄漏？
• #11898: 使用复杂 :not() 选择器的 prevAll() 会以错误的顺序返回结果
• #12132: 在 IE10 中，克隆没有 parentNode 的对象元素时出现错误

偏移量

• #10996: 简化 offset()
• #11823: 删除 webkitConvertPointFromNodeToPage

选择器

• #3778: 选择器匹配问题
• #5568: 选择器在 FF/IE 中对注释标签的行为不同
• #7596: xpath 选择器属性名称带有方括号 [] 失败
• #8473: 在 IE9rc 中，*[tabIndex] 也会选择所有没有 tabindex 的元素
• #8906: .(prevAll('span:has(input,select,textarea)')
• #9400: 弃用 :text、:radio、:checkbox 等选择器扩展
• #9810: 重写位置选择器逻辑
• #10003: #6963 的回归/BC 突破
• #10074: 链接两个 [] 选择器和 :first 不起作用
• #10499: :has() 内部的 :nth-child() 被视为在外部
• #10570: 在 IE7 中，当页面上存在跨域 iframe 时，:text 选择器会抛出错误
• #10697: Sizzle 重构
• #10799: 使用 [name="name"] 选择器时，结果不一致（也会破坏 .has）
• #10809: :focus 伪类解析器中使用“.activeElement” 的错误测试
• #11109: Sizzle: Expr.relative 过早截断
• #11120: IE7 中的一些选择器中的制表符会中断
• #11814: Sizzle 的元素根 QSA 策略（即附加临时 ID）不考虑逗号和其他选择器分隔符
• #11826: 探索 Sizzle 中 matchesSelector 的解析缓存系统
• #11902: :not + :contains 选择器
• #11918: 使用带有 ':' 的标签名时，:eq 选择器出现问题
• #11959: 添加对 :active 选择器的支持
• #11961: 使用 jQuery#is 时，“最大调用堆栈大小超出”
• #11966: 后代选择器
• #11969: 收集兄弟姐妹时缺少 null 检查
• #12054: 未捕获的 TypeError：对象 #<HTMLDocument> 没有方法 'getAttribute'
• #12057: Sizzle 回归
• #12082: .find() POS 选择器在 1.8b2 中不再起作用
• #12153: 选择器中出现错误

支持

• #9385: 弃用 jQuery.browser
• #11163: jQuery.support.checkClone 始终为 true
• #11249: 加载 jQuery 1.7.1 时，Chrome 18 中出现 CSP 错误
• #11439: 使用了 jQuery.support.parentNode，但没有定义。
• #11721: 弃用和删除 jQuery.support.boxModel 的内部使用
• #11757: jQuery 1.7.2 中，iframe 内的 IE 8 内存累积
• #11766: 将 jQuery.support 移动到“不稳定”状态

遍历

• #9800: 新方法：.addBack（取代 .andSelf）
• #11539: 所有版本的 jQuery 都不支持 $([text Element].parentNode).has?(other_element) 上的 .has()
• #11543: .has 不适用于分离的元素
• #11706: `.has()` 在文档片段上失败
• #11738: 删除 .closest(Array) 返回 Array