htmx 2.0.0 已發布！

htmx 2.0.0 版本發布

我很高興宣布 htmx 2.0 的發布。此版本結束了對 Internet Explorer 的支持，並收緊了一些預設值，但沒有改變庫的大部分核心功能或核心 API。

請注意，我們並未將 2.0 標記為 NPM 中的 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 屬性已被移除，改用較不駭客的 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>

或下載