htmx/www/index.md
2022-09-30 12:44:06 -06:00

3.5 KiB

layout title
layout.njk </> htmx - high power tools for html
</> 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 & submit events trigger them?
  • Why should only GET & POST methods 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="https://unpkg.com/htmx.org@1.8.0"></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 also available.