0b52a8c6a3
As per #800. * Recommend downloading htmx as the main way of installing it. * Cover npm installation in a bit more detail. * Note the downsides of unpkg.com and always recommend with the integrity SHA. * Use `<script defer>` in all `<script>` examples. This tells the browser to defer the parsing and processing of the script until all content is on display, increasing performance. [See HTML spec diagram](https://html.spec.whatwg.org/multipage/scripting.html#attr-script-defer).
3.5 KiB
| layout | title |
|---|---|
| layout.njk | </> htmx - high power tools for html |
introduction
htmx gives you access to AJAX, CSS Transitions, WebSockets and Server Sent Events directly in HTML, using attributes, so you can build modern user interfaces with the simplicity and power of hypertext
htmx is small (~10k min.gz'd), dependency-free, extendable & IE11 compatible
motivation
- Why should only
<a>and<form>be able to make HTTP requests? - Why should only
click&submitevents trigger them? - Why should only
GET&POSTmethods be available? - Why should you only be able to replace the entire screen?
By removing these arbitrary constraints, htmx completes HTML as a hypertext
quick start
<script src="htmx.min.js" defer></script>
<!-- have a button POST a click via AJAX -->
<button hx-post="/clicked" hx-swap="outerHTML">
Click Me
</button>
The hx-post and hx-swap attributes on
this button tell htmx:
"When a user clicks on this button, issue an AJAX request to /clicked, and replace the entire button with the HTML response"
htmx is the successor to intercooler.js
Read the docs introduction for a more in-depth... introduction.
sponsors
Thank you to our corporate sponsors!
If you use htmx commercially & wish to support the project you can sponsor us via Github
Consulting is available.
haiku
javascript fatigue:
longing for a hypertext
already in hand