This response header can be used to trigger a client side redirection without reloading the whole page. Instead of changing the page’s location it will act like following a hx-boost link, creating a new history entry, issuing an ajax request to the value of the header and pushing the path into history.
A sample response would be:
HX-Location: /test
Which would push the client to test as if the user had clicked on <a href="/test" hx-boost="true">
If you want to redirect to a specific target on the page rather than the default of document.body, you can pass more details along with the event, by using JSON for the value of the header:
HX-Location: {"path":"/test2", "target":"#testdiv"}
Path is required and is url to load the response from. The rest of the data mirrors the ajax api context, which is:
source - the source element of the requestevent - an event that “triggered” the requesthandler - a callback that will handle the response HTMLtarget - the target to swap the response intoswap - how the response will be swapped in relative to the targetvalues - values to submit with the requestheaders - headers to submit with the requestselect - allows you to select the content you want swapped from a responsepush - set to 'false' or a path string to prevent or override the URL pushed to browser location historyreplace - a path string to replace the URL in the browser location historyResponse headers are not processed on 3xx response codes. see Response Headers