核心架構

Outbound

推導對應的導航目標與導航行為。


導航行為由兩個層面共同決定:


語系承載

定義語系在導覽 URL 中所採用的表達形式。

可選擇以下承載方式:path | host | query

關於設定方式,詳見:localeCarrier

host 需額外定義語系與主機名稱的對應關係,詳見:host


導航意圖

導航意圖由 導航目的地(Destination)語系(Locale) 共同構成。

Destination 在不同工具中可能以 hrefurl 等名稱出現。


意圖組合範例

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。
關於具體的整合方式,詳見:框架指南