htmx 2.0.0 已发布！

htmx 2.0.0 发布

我很高兴地宣布 htmx 2.0 发布。此版本不再支持 Internet Explorer，并收紧了一些默认设置，但不会改变大多数核心功能或库的核心 API。

请注意，我们不会在 NPM 中将 2.0 标记为 latest，因为我们不想强制升级依赖于 htmx 非版本化 CDN URL 的用户。相反，1.x 将保持为 latest，而 2.0 行将保持为 next 直到 2025 年 1 月 1 日。但是，该网站将引用 2.0。

主要变更

• 所有扩展都已从核心存储库移至 自己的存储库 和网站：https://extensions.htmx.org。它们现在都单独进行版本控制，并且可以在正常的（缓慢的）htmx 发布节奏之外进行开发。
  • 大多数 1.x 扩展可以与 2.x 兼容，但是 SSE 扩展确实存在一个中断，必须升级。
  • 旧的扩展仍然保留在 /dist/ext 目录中，以避免破坏 unpkg 等 CDN 的 URL，但请在将来迁移到新的扩展 URL。
• 我们删除了已弃用的 hx-sse 和 hx-ws 属性，以支持扩展，这些扩展在 1.x 中可用并推荐使用。
• HTTP DELETE 请求现在使用参数而不是表单编码主体来表示其有效负载（这与规范一致）。
• 我们现在在 /dist 中提供针对各种 JavaScript 模块样式的特定文件。
  • ESM 模块：/dist/htmx.esm.js
  • AMD 模块：/dist/htmx.amd.js
  • CJS 模块：/dist/htmx.cjs.js
  • /dist/htmx.js 文件继续支持浏览器加载
• hx-on 属性及其特殊语法已被删除，取而代之的是更不 hack 的 hx-on: 语法。

次要变更

• 我们做了一些默认更改
  • htmx.config.scrollBehavior 已从 'smooth' 更改为 'instant'
  • 如前所述，DELETE 请求现在使用查询参数而不是表单编码主体。可以通过将 htmx.methodsThatUseUrlParams 设置为值 ['get'] 来恢复此更改。
  • htmx.config.selfRequestsOnly 现在默认为 true 而不是 false

功能

实际上没有太多

• selectAndSwap() 内部 API 方法已被公共（且更强大的）swap() 方法取代
• Web 组件支持已 得到显著改善
• 以及此版本中最重要的功能：该网站 现在支持深色模式！（感谢 @pokonski！）

完整的升级指南可以在此处找到

htmx 1.x -> 2.x 迁移指南

如果您需要 IE 兼容性，1.x 将在可预见的未来继续得到支持。

安装

htmx 2.0 可以通过引用版本 2.0.0 的包管理器进行安装，也可以通过 CDN 进行链接。

<script src="https://unpkg.com/htmx.org@2.0.0/dist/htmx.min.js"></script>

或 下载