htmx 1.x Compatibility Extension

htmx-1-compat エクステンションにより、htmx 1.x から htmx 2 にシームレスにアップグレードできます。

インストール

<script src="https://unpkg.com/htmx-ext-htmx-1-compat@2.0.0/htmx-1-compat.js"></script>

対象範囲

Htmx 2 にはいくつかの 重大な変更 が導入されました。

htmx 1.x から htmx 2 へのアップグレードを容易にするために、このエクステンションを提供します。このエクステンションでは大部分の重大な変更が元に戻されるため、アプリケーションを破損することなくその他の変更を利用できます。

廃止された属性

• htmx 2 では推奨されなくなった hx-ws 属性と hx-sse 属性が削除されましたが、このエクステンションではこれらが復元されています。
• htmx 2 では推奨されなくなった hx-on 属性が削除され、代わりにワイルドカード hx-on* 属性 が使用されていますが、このエクステンションではこの hx-on 属性が復元されています。

既定の設定の変更

• htmx.config.scrollBehavior が ‘smooth’ に戻されました。
• DELETE リクエストで、URL パラメーターではなくフォームエンコードされた本文が使用されるようになりました (htmx 2 では 仕様 に従って DELETE の既定設定として URL パラメーターが使用されます)。
• 既定でクロスドメインリクエストが許可されるようになりました (htmx 2 では既定で禁止されます)。

対象外

• htmx 2 では IE11 のサポートが終了しており、このエクステンションではそれを元に戻すことはできません。IE11 のサポートが必要な場合は、サポートが継続される htmx 1 を使用してください。
• htmx 2 には、エクステンション API に swap メソッド という重大な変更が導入されています。コアエクステンションのみを使用している場合は、追加の作業は必要ありません。カスタムエクステンションまたはコミュニティエクステンションを使用していた場合は、htmx 2 の API で動作するようにアップデートされていることを確認してください。