htmx Reference

Use the index below to open the most specific page for the user's question. Search the local references/ folder with rg when unsure which page contains the answer.

Reference Index

General

• Events: Documentation page

  • Reference: events.md

• Javascript API: This documentation describes the JavaScript API for htmx, including methods and properties for configuring the behavior of htmx, working with CSS classes, AJAX requests, event handling, and DOM manipulation. The API provides helper functions primarily intended for extension development and event management.

  • Reference: api.md

Attributes

• hx-boost: The hx-boost attribute in htmx enables progressive enhancement by converting standard HTML anchors and forms into AJAX requests, maintaining graceful fallback for users without JavaScript while providing modern dynamic page updates for those with JavaScript enabled.

  • Reference: attributes/hx-boost.md

• hx-confirm: The hx-confirm attribute in htmx provides a way to add confirmation dialogs before executing requests, allowing you to protect users from accidental destructive actions. This documentation explains how to implement confirmation prompts and customize their behavior through event handling.

  • Reference: attributes/hx-confirm.md

• hx-delete: The hx-delete attribute in htmx will cause an element to issue a DELETE request to the specified URL and swap the returned HTML into the DOM using a swap strategy.

  • Reference: attributes/hx-delete.md

• hx-disable: The hx-disable attribute in htmx will disable htmx processing for a given element and all its children.

  • Reference: attributes/hx-disable.md

• hx-disabled-elt: The hx-disabled-elt attribute in htmx allows you to specify elements that will have the disabled attribute added to them for the duration of the request.

  • Reference: attributes/hx-disabled-elt.md

• hx-disinherit: The hx-disinherit attribute in htmx lets you control how child elements inherit attributes from their parents. This documentation explains how to selectively disable inheritance of specific htmx attributes or all attributes, allowing for more granular control over your web application's behavior.

  • Reference: attributes/hx-disinherit.md

• hx-encoding: The hx-encoding attribute in htmx allows you to switch the request encoding from the usual application/x-www-form-urlencoded encoding to multipart/form-data, usually to support file uploads in an AJAX request.

  • Reference: attributes/hx-encoding.md

• hx-ext: The hx-ext attribute in htmx enables one or more htmx extensions for an element and all its children. You can also use this attribute to ignore an extension that is enabled by a parent element.

  • Reference: attributes/hx-ext.md

• hx-get: The hx-get attribute in htmx will cause an element to issue a GET request to the specified URL and swap the returned HTML into the DOM using a swap strategy.

  • Reference: attributes/hx-get.md

• hx-headers: The hx-headers attribute in htmx allows you to add to the headers that will be submitted with an AJAX request.

  • Reference: attributes/hx-headers.md

• hx-history: The hx-history attribute in htmx allows you to prevent sensitive page data from being stored in the browser's localStorage cache during history navigation, ensuring that the page state is retrieved from the server instead when navigating through history.

  • Reference: attributes/hx-history.md

• hx-history-elt: The hx-history-elt attribute in htmx allows you to specify the element that will be used to snapshot and restore page state during navigation. In most cases we do not recommend using this element.

  • Reference: attributes/hx-history-elt.md

• hx-include: The hx-include attribute in htmx allows you to include additional element values in an AJAX request.

  • Reference: attributes/hx-include.md

• hx-indicator: The hx-indicator attribute in htmx allows you to specify the element that will have the htmx-request class added to it for the duration of the request. This can be used to show spinners or progress indicators while the request is in flight.

  • Reference: attributes/hx-indicator.md

• hx-inherit: The hx-inherit attribute in htmx allows you to explicitly control attribute inheritance behavior between parent and child elements, providing fine-grained control over which htmx attributes are inherited when the default inheritance system is disabled through configuration.

  • Reference: attributes/hx-inherit.md

• hx-on: The hx-on attributes in htmx allow you to write inline JavaScript event handlers directly on HTML elements, supporting both standard DOM events and htmx-specific events with improved locality of behavior.

  • Reference: attributes/hx-on.md

• hx-params: The hx-params attribute in htmx allows you to filter the parameters that will be submitted with an AJAX request.

  • Reference: attributes/hx-params.md

• hx-patch: The hx-patch attribute in htmx will cause an element to issue a PATCH request to the specified URL and swap the returned HTML into the DOM using a swap strategy.

  • Reference: attributes/hx-patch.md

• hx-post: The hx-post attribute in htmx will cause an element to issue a POST request to the specified URL and swap the returned HTML into the DOM using a swap strategy.

  • Reference: attributes/hx-post.md

• hx-preserve: The hx-preserve attribute in htmx allows you to keep an element unchanged during HTML replacement. Elements with hx-preserve set are preserved by id when htmx updates any ancestor element.

  • Reference: attributes/hx-preserve.md

• hx-prompt: The hx-prompt attribute in htmx allows you to show a prompt before issuing a request. The value of the prompt will be included in the request in the HX-Prompt header.

  • Reference: attributes/hx-prompt.md

• hx-push-url: The hx-push-url attribute in htmx allows you to push a URL into the browser location history. This creates a new history entry, allowing navigation with the browser's back and forward buttons.

  • Reference: attributes/hx-push-url.md

• hx-put: The hx-put attribute in htmx will cause an element to issue a PUT request to the specified URL and swap the returned HTML into the DOM using a swap strategy.

  • Reference: attributes/hx-put.md

• hx-replace-url: The hx-replace-url attribute in htmx allows you to replace the current URL of the browser location history.

  • Reference: attributes/hx-replace-url.md

• hx-request: The hx-request attribute in htmx allows you to configure the request timeout, whether the request will send credentials, and whether the request will include headers.

  • Reference: attributes/hx-request.md

• hx-select: The hx-select attribute in htmx allows you to select the content you want swapped from a response.

  • Reference: attributes/hx-select.md

• hx-select-oob: The hx-