htmx/www/content/attributes/hx-disabled-elt.md

27 lines
1012 B
Markdown

+++
title = "hx-disabled-elt"
+++
The `hx-disabled-elt` attribute allows you to specify elements that will have the `disabled` attribute
added to them for the duration of the request.
The value of this attribute is a CSS query selector of the element or elements to apply the class to,
or the keyword [`closest`](https://developer.mozilla.org/docs/Web/API/Element/closest), followed by a CSS selector,
which will find the closest ancestor element or itself, that matches the given CSS selector (e.g. `closest tr`), or
the keyword `this`
Here is an example with a button that will disable itself during a request:
```html
<button hx-post="/example" hx-disabled-elt="this">
Post It!
</button>
```
When a request is in flight, this will cause the button to be marked with [the `disabled` attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/disabled),
which will prevent further clicks from occurring.
## Notes
* `hx-disable-elt` is inherited and can be placed on a parent element