The htmx-1-compat
extension allows you to almost seamlessly upgrade from htmx 1.x to htmx 2.
<script src="https://unpkg.com/htmx-ext-htmx-1-compat@2.0.0/htmx-1-compat.js"></script>
Htmx 2 introduced a few breaking changes.
To make upgrading from htmx 1.x to htmx 2 easier, we're providing this extension that reverts most of those, so you're able to benefit from the other changes without breaking your application.
- htmx 2 removed the deprecated hx-ws and hx-sse attributes, that this extension restores.
- htmx 2 removed the deprecated
hx-on
attribute in favor of the wildcardhx-on*
attribute, that this extension restores.
- reverts htmx.config.scrollBehavior to 'smooth'.
- makes
DELETE
requests use a form-encoded body rather than URL parameters (htmx 2 uses URL parameters forDELETE
as default as per the spec). - allows cross-domain requests by default (htmx 2 now forbids it by default).
- IE11 support was dropped in htmx 2, and this extension cannot revert that. If you need IE11 support, please stay with htmx 1 that will continue being supported.
- htmx 2 introduced the breaking change that is the swap method to the extensions API. If you were only using core extensions, then you shouldn't need any additional work. If you were using custom or community extensions, make sure that they were updated to work with htmx 2's API.