此响应头可用于触发客户端重定向而无需重新加载整个页面。它不会改变页面位置,而是像跟随hx-boost
链接一样操作,创建新的历史记录条目,向头信息中的值发起ajax请求并将路径推入历史记录。
示例响应:
HX-Location: /test
这会将客户端跳转到/test,就像用户点击了<a href="/test" hx-boost="true">
一样
如果要重定向到页面上的特定目标而非默认的document.body,可以通过使用JSON作为头信息的值来传递更多细节:
HX-Location: {"path":"/test2", "target":"#testdiv"}
path是必需的,表示要加载响应的URL。其余数据镜像ajax
api上下文,包括:
source
- 请求的源元素event
- "触发"请求的事件handler
- 处理响应HTML的回调函数target
- 交换响应的目标元素swap
- 响应相对于目标的交换方式values
- 随请求提交的值headers
- 随请求提交的头信息select
- 允许从响应中选择要交换的内容3xx响应码不会处理响应头。参见响应头