htmx 2.0.0 がリリースされました!

htmx 2.0.0 リリース

htmx 2.0のリリースを発表いたします。今回のリリースでは Internet Explorer のサポートを終了し、デフォルトを厳密化しておりますが、ライブラリの主要な機能やコア API のほとんどは変更されていません。

htmx のバージョンなし CDN URL に依存しているユーザーが強制的にアップグレードされないようにするために、npm では 2.0 を latest としてマークせず、1.x が引き続き latest のままになり、2.0 ラインは2025年1月1日まで next のままになります。ただし、ウェブサイト では 2.0 が参照されます。

主な変更

• すべての拡張機能はコア リポジトリから 独自のレポジトリ とウェブサイト https://extensions.htmx.org に移動しました。これらは現在すべて個別にバージョン管理されており、通常の（遅い）htmx リリース サイクルの外で開発できます。
  • ほとんどの 1.x 拡張機能は 2.x で動作しますが、SSE 拡張機能では中断が発生し、アップグレードする必要があります。
  • 古い拡張機能は unpkg などの CDN の URL が壊れないように引き続き /dist/ext ディレクトリにありますが、今後は新しい拡張機能 URL に移動してください。
• 廃止された hx-sse と hx-ws 属性は、1.x で利用可能かつ推奨されていた拡張機能の代わりに削除されました。
• HTTP DELETE 要求は、ペイロードにフォームエンコードの本文ではなく、パラメータを使用するようになりました（これは仕様に準拠しています）
• さまざまな JavaScript モジュールスタイル用の特定のファイルが /dist 内に提供されるようになりました
  • 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 は false ではなく、true をデフォルトにするようになりました。

機能

実際、あまりありません

• selectAndSwap() 内部 API メソッドは、パブリックで（はるかに優れた）swap() メソッドに置き換えられました
• Web コンポーネント サポートが 大幅に向上 しました
• そして今回のリリースで最大の機能は、ウェブサイトがダークモードをサポートしていることです！（ありがとうございます @pokonski！）

完全なアップグレードガイドはこちら

htmx 1.x -> 2.x 移行ガイド

IE との互換性が必要な場合は、1.xは当面サポートが継続します。

インストール

バージョン 2.0.0 を参照するパッケージマネージャーを介して htmx 2.0 をインストールするか、CDN を介してリンクできます。

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

または ダウンロード