mirror of
https://github.com/bigskysoftware/htmx.git
synced 2025-09-28 21:41:40 +00:00

- Changed API to look for event names and wait durations. - Changed default triggers to mousedown (0ms wait time) - Added default wait on mouseover events (100ms) - Now using htmx.ajax for HX-GET requests. This makes sure headers match the actual HTTP requestswhen they're made - Updated manual tests - More tests and documentation to come
high power tools for HTML
introduction
htmx allows you to access 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 (~9k 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
&submit
events trigger them? - Why should only GET & POST 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
<!-- Load from unpkg -->
<script src="https://unpkg.com/htmx.org@1.0.2"></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 tell htmx:
"When a user clicks on this button, issue an AJAX request to /clicked, and replace the entire button with the response"
htmx is the successor to intercooler.js
website & docs
contributing
- please write code, including tests, in ES5 for IE 11 compatibility
- please include test cases in
/test
and docs in/www
- if you are adding a feature, consider doing it as an extension instead to keep the core htmx code tidy
- development pull requests should be against the
dev
branch, docs fixes can be made directly againstmaster
haiku
javascript fatigue:
longing for a hypertext
already in hand
Description
Languages
JavaScript
92%
HTML
7.1%
CSS
0.4%
TypeScript
0.3%
Ruby
0.1%