I’m happy to announce the first alpha release of htmx 2.0
This is an alpha release and should NOT be considered ready for production. We are releasing it to begin testing the code against real world scenarios to figure out what is broken and what needs improvement.
If you are able to do so, please switch to the release and do a quick run through any htmx-powered functionality you have and let us know if there are issues.
Of particular concern to us are the following changes:
hx-sse and hx-ws attributes in favor of the extensions (which are available in 1.x)head tag processing from the head-extension into the core, and head processing is now the default
behavior for boosted links.DELETE requests now use parameters, rather than form encoded bodies, for their payload (This is in accordance w/ the spec.)A complete upgrade guide can be found here:
htmx 1.x -> 2.x Migration Guide
Note that htmx 2.x will no longer be IE compatible, but 1.x will continue to be supported for IE users.
The alpha can be installed via a package manager referencing version 2.0.0-alpha1, or can be linked via a CDN:
<script src="https://unpkg.com/htmx.org@2.0.0-alpha1/dist/htmx.min.js"></script>
or Downloaded
Extensions have been removed from the main codebase and are now in this github repo:
https://github.com/bigskysoftware/htmx-extensions/tree/main/ext
They will eventually be available at https://extensions.htmx.org and in NPM but for now must be linked from the github repo.
There was one breaking change in the extensions, SSE, so you must use the newer version of that extension:
https://github.com/bigskysoftware/htmx-extensions/blob/main/ext/sse.js
head tag merging functionality out of the boxhtmx.config.disableInheritance config variablehtmx.config.responseHandling config variable