mirror of
https://github.com/bigskysoftware/htmx.git
synced 2025-09-30 14:31:47 +00:00
27 lines
899 B
Markdown
27 lines
899 B
Markdown
---
|
|
layout: layout.njk
|
|
title: </> htmx - hx-post
|
|
---
|
|
|
|
## `hx-post`
|
|
|
|
The `hx-post` attribute will cause an element to issue a `POST` to the specified URL and swap
|
|
the HTML into the DOM using a swap strategy:
|
|
|
|
```html
|
|
<button hx-post="/account/enable" hx-target="body">
|
|
Enable Your Account
|
|
</button>
|
|
```
|
|
|
|
This example will cause the `button` to issue a `POST` to `/account/enable` and swap the returned HTML into
|
|
the `innerHTML` of the `body`.
|
|
|
|
### Notes
|
|
|
|
* `hx-post` is not inherited
|
|
* You can control the target of the swap using the [hx-target](/attributes/hx-target) attribute
|
|
* You can control the swap strategy by using the [hx-swap](/attributes/hx-swap) attribute
|
|
* You can control what event triggers the request with the [hx-trigger](/attributes/hx-trigger) attribute
|
|
* You can control the data submitted with the request in various ways, documented here: [Parameters](/docs/#parameters)
|