hx-push-url

hx-push-url 属性允许您将 URL 推送到浏览器 location history 中。 这将创建一个新的历史记录条目,允许使用浏览器的后退和前进按钮进行导航。 htmx 会对当前 DOM 进行快照并将其保存到其历史记录缓存中,并在导航时从该缓存中恢复。

此属性的可能值包括:

  1. true,这会将获取的 URL 推送到历史记录中。
  2. false,这会禁用推送获取的 URL(如果由于继承或 hx-boost 而原本会被推送)。
  3. 要推送到位置栏的 URL。 这可以是相对 URL 或绝对 URL,具体取决于 history.pushState()

以下是一个示例:

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

这将导致 htmx 将当前 DOM 快照保存到 localStorage 中,并将 URL /account 推送到浏览器位置栏。

另一个示例:

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

这将把 URL /account/home 推送到位置历史记录中。

Notes