htmx 2.0.0 已发布！

htmx 2.0.0 发布

我很高兴地宣布 htmx 2.0 的发布。此次发布结束了 Internet Explorer 的支持，并收紧了一些默认设置，但并未更改库的核心功能或核心 API 的绝大多数部分。

请注意，我们不会在 NPM 中将 2.0 标记为 latest，因为我们不想强制升级那些依赖非版本化 CDN URL 的 htmx 用户。相反，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 属性及其特殊语法已被移除，转而使用不太 hacky 的 hx-on: 语法。

次要变更

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

新功能

实际上不多：

• selectAndSwap() 内部 API 方法已被公共的（且更好的）swap() 方法替换
• Web Component 支持已大幅改进
• 此次发布最大的功能：网站 现在支持深色模式！（感谢 @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>

或者 下载