htmx/www/attributes/hx-preserve.md
David Guillot d6037bde67
Minor changes in docs (#1033)
* Minor change in active-search docs

You don't want people to believe they need a POST request to run a search query.

* More limitations of hx-preserve
2022-09-06 07:05:19 -06:00

19 lines
798 B
Markdown

---
layout: layout.njk
title: </> htmx - hx-preserve
---
## `hx-preserve`
The `hx-preserve` attribute 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.
You *must* set an unchanging `id` on elements for `hx-preserve` to work.
The response requires an element with the same `id`, but its type and other attributes are ignored.
Note that some elements cannot unfortunately be preserved properly, such as `<input type="text">` (focus and caret position are lost), iframes or certain types of videos. To tackle some of these cases we recommend the [morphdom extension](/extensions/morphdom-swap/), which does a more elaborate DOM
reconciliation.
### Notes
* `hx-preserve` is not inherited