このレスポンスヘッダーを使用すると、ページ全体をリロードせずにクライアント側のリダイレクトをトリガーできます。ページの場所を変更せずに、hx-boost
リンクをたどるように動作し、新しい履歴エントリを作成し、ヘッダーの値に Ajax リクエストを送信し、パスを履歴にプッシュします。
レスポンスのサンプルは次のようになります。
HX-Location: /test
これは、ユーザーが <a href="/test" hx-boost="true">
をクリックしたかのようにクライアントをテストにプッシュします。
document.body の既定値ではなく、ページ上の特定のターゲットにリダイレクトする場合は、JSON をヘッダーの値として使用してイベントと一緒に詳細を渡すことができます。
HX-Location: {"path":"/test2", "target":"#testdiv"}
パスは必須で、レスポンスを読み込むための URL です。残りのデータは、次のような ajax
api コンテキストを反映しています。
source
- リクエストのソース要素event
- リクエストを「トリガー」したイベントhandler
- レスポンス HTML を処理するコールバックtarget
- レスポンスを入れ替えるターゲットswap
- レスポンスがターゲットに対してどのように入れ替えられるかvalues
- リクエストと一緒に送信する値headers
- リクエストと一緒に送信するヘッダーselect
- レスポンスから入れ替えてほしいコンテンツを選択できます。レスポンスヘッダーは 3xx レスポンスコードでは処理されません。レスポンスヘッダー を参照してください。