htmx 1.x 兼容性扩展

htmx-1-compat 扩展允许你几乎无缝地从 htmx 1.x 升级到 htmx 2。

安装

<script src="https://unpkg.com/[email protected]/htmx-1-compat.js"></script>

涵盖的内容

Htmx 2 引入了一些重大变化。

为了使从 htmx 1.x 升级到 htmx 2 更加容易，我们提供了这个扩展来恢复其中的大部分内容，这样你就可以从其他版本更新中受益而不会破坏你的应用程序。

已过时的属性

• htmx 2 删除了已弃用的 hx-ws 和 hx-sse 属性，此扩展将其恢复。
• htmx 2 删除了弃用的 hx-on 属性，转而使用通配符 hx-on* 属性，此扩展恢复了该属性。

默认更改

• 将 htmx.config.scrollBehavior 恢复为“smooth”。
• 使 DELETE 请求使用表单编码主体而不是 URL 参数（根据规范，htmx 2 默认为 DELETE 使用 URL 参数）。
• 默认允许跨域请求（htmx 2 现在默认禁止）。

它不涵盖的内容

• htmx 2 中已放弃对 IE11 的支持，此扩展无法恢复此状态。如果你需要 IE11 支持，请继续使用 htmx 1，它将继续受支持。
• htmx 2 引入了重大更改，即扩展 API 中的 swap 方法。如果你仅使用核心扩展，则不需要进行任何额外工作。如果你使用自定义或社区扩展，请确保已更新它们以与 htmx 2 的 API 配合使用。