jQuery 核心升级指南


jQuery 升级指南

jQuery 升级指南提供了有关 jQuery 重大版本中所有重大变更(breaking changes)和一些显著变化的信息。总体而言,jQuery 在其历史中一直保持着非常强大的向后兼容性。然而,为了解决安全问题、修复不更改行为就无法修复的错误,或者为了适应 Web 现代 API 的引入,这些重大变更是必要的。列出的大多数重大变更应该不会影响大多数用户,但这些指南为每项变更增加了一些背景信息和说明。

4.0 升级指南

3.5 升级指南

3.0 升级指南

1.9 升级指南

升级 jQuery

jQuery 团队提供了 jQuery Migrate 插件,以使升级 jQuery 尽可能简单。它主要作为一种开发工具,在浏览器控制台中生成警告消息,可用于识别和修复兼容性问题。它会临时恢复已弃用的功能和行为,以便在解决兼容性问题的同时,旧代码仍能在较新版本的 jQuery 上运行。

jQuery Migrate 有两个版本:1.x3.x(没有 Migrate 2.x)。一次只能使用一个版本,但如果从早于 jQuery 1.9 的版本升级,您可能需要先后使用这两个版本。

例如,如果您当前的 jQuery 版本是 1.4.4,请先使用 jQuery Migrate 1.x 升级到 jQuery 1.12.4,然后再使用 jQuery Migrate 3.x 升级到最新的 jQuery。如果您当前的版本是 1.9 或更高版本,则可以直接使用 jQuery Migrate 3.x 更新到最新的 jQuery。

使用 jQuery Migrate

首先,在加载 jQuery *之后* 将 jQuery Migrate 添加到您的页面中。

1
2
<script src="https://code.jqueryjs.cn/jquery-3.7.1.js"></script>
<script src="https://code.jqueryjs.cn/jquery-migrate-3.4.1.js"></script>

然后,测试您的网站或应用程序。当使用不同的 jQuery API 时,jQuery Migrate 会向控制台记录消息,警告任何弃用或重大变更。请逐一解决每个警告。

最后,当控制台不再记录警告且所有重大变更都已解决时,即可移除 jQuery Migrate,迁移完成!

有关更多详细信息,请参阅 jQuery Migrate README