htmx/www/attributes/hx-push-url.md
2020-06-29 06:57:54 +02:00

35 lines
850 B
Markdown

---
layout: layout.njk
title: </> htmx - hx-push-url
---
## `hx-push-url`
The `hx-push-url` attribute allows you to "push" a new entry into the browser location bar, which creates
a new history entry, allowing back-button and general history navigation. The possible values of this
attribute are `true`, `false` or a custom string.
Here is an example:
```html
<div hx-get="/account" hx-push-url="true">
Go to My Account
</div>
```
This will cause htmx to snapshot the current DOM to `localStorage` and push the URL `/account' into the browser
location bar.
```html
<div hx-get="/account" hx-push-url="/account/home">
Go to My Account
</div>
```
This will push the URL `/account/home' into the browser location bar.
### Notes
* `hx-push-url` is inherited and can be placed on a parent element
* see also the `HX-Push` response header