此响应头可用于触发客户端重定向而无需重新加载整个页面。它不会改变页面位置,而是像跟随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响应码不会处理响应头。参见响应头