hx-replace-url

Заменяет текущий URL в истории браузера

Атрибут hx-replace-url позволяет заменить текущий URL в истории переходов браузера.

Он перезаписывает текущую запись в истории, а не добавляет новую. Ядро htmx восстанавливает страницу, повторно загружая её URL. Используйте расширение hx-history-cache, чтобы вместо этого восстанавливать сохранённые снимки DOM.

Синтаксис

<div hx-get="/account" hx-replace-url="true">Go to My Account</div>

Возможные значения этого атрибута:

true — заменяет загруженный URL в панели навигации браузера.
false — отменяет замену загруженного URL, если она иначе произошла бы из-за наследования.
URL, который будет установлен в адресной строке. Он может быть относительным или абсолютным, в соответствии с history.replaceState().

Пример:

<div hx-get="/account" hx-replace-url="true">
  Go to My Account
</div>

Текущая запись в истории заменяется на /account в адресной строке браузера.

Ещё один пример:

<div hx-get="/account" hx-replace-url="/account/home">
  Go to My Account
</div>

Текущая запись в истории заменяется на /account/home в адресной строке браузера.

Примечания

Заголовок ответа HX-Replace-Url работает аналогичным образом и может переопределить этот атрибут.
Атрибут hx-push-url работает аналогичным образом и используется чаще; он создаёт новую запись в истории, а не заменяет текущую.

Licensed under the Zero-Clause BSD License.
https://four.htmx.org/reference/attributes/hx-replace-url/