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 默认情况下使用 URL 参数进行 DELETE，符合 规范）。
• 默认情况下允许跨域请求（htmx 2 现在默认情况下禁止它）。

未涵盖范围

• htmx 2 中删除了对 IE11 的支持，这个扩展无法恢复它。如果您需要 IE11 支持，请继续使用将继续获得支持的 htmx 1。
• htmx 2 引入了对扩展 API 的 swap 方法 作为重大变更。如果您只使用核心扩展，那么您不需要进行任何额外的工作。如果您使用自定义扩展或社区扩展，请确保它们已更新以使用 htmx 2 的 API。