核心架構
Outbound
推導對應的導航目標與導航行為。
導航行為由兩個層面共同決定:
語系承載
定義語系在導覽 URL 中所採用的表達形式。
可選擇以下承載方式:path | host | query。
關於設定方式,詳見:localeCarrier
host需額外定義語系與主機名稱的對應關係,詳見:host
導航意圖
導航意圖由 導航目的地(Destination) 與 語系(Locale) 共同構成。
Destination 在不同工具中可能以
href、url等名稱出現。
意圖組合範例
1. 僅提供 Destination
僅指定 Destination 時,不會改變目前語系。
輸入 Destination: "/fr/about" 結果 "/en" → "/en/about"
就算 Destination 裡有 Locale 片段,只要沒有顯性指定,語系也不會切換。
2. 僅提供 Locale
僅指定語系時,會在當前路徑上切換語系。
輸入 Locale: "fr" 結果 "/en" → "/fr"
3. 同時提供 Destination 與 Locale
同時指定 Destination 與 Locale,會產生完整且明確的導航結果。
輸入 Destination: "/about" Locale: "fr" 結果 "/en" → "/fr/about"
模板路徑
Destination 可透過 {locale} 佔位符描述 Locale 在路徑中的位置,避免將語系誤解為實際路徑的一部分。
輸入 Destination: "/admin/{locale}/about" 結果 "/admin/en" → "/admin/en/about"
此形式有助於保持 Destination 的結構語意清晰。
整合方式
在各執行環境中,Intor 提供對應的 導航工具,用於處理 Outbound Routing。
關於具體的整合方式,詳見:框架指南 。