繁體中文(香港)
用 OIDC ui_locales 本地化你的 Logto 登入體驗
讓你的登入體驗對每位用戶都感覺像本地原生。在本教學中,你會學到如何用標準 OIDC 參數 ui_locales,為 Logto 的登入 UI 及相關電郵設置運行時語言。
讓你的登入體驗對每位用戶都感覺像本地原生。在本教學中,你會學到如何用標準 OIDC 參數 ui_locales,為 Logto 的登入 UI 及相關電郵設置運行時語言。
Logto 已經支援多語言內容和自動偵測,但有時你希望為特定互動明確選擇語言:
此外,ui_locales 是許多身份供應商和 SDK 支援的標準參數。
uiLocales 向電郵模板傳遞原始值(例如:「請求語言:{{uiLocales}}」)詳情參閱:UI locales 說明文件。
可選但建議:
Logto SDK 讓你在登入時傳遞額外 OIDC 參數。於 extraParams 加入 ui_locales:
注意:
fr-CA,若無則 fr,再無則 en)。ui_locales 同時與其他標準/自訂參數一起用(如 login_hint、organization_id 或指定初始畫面)。如果你用手動(或通用 OIDC client)組裝 OIDC 授權請求,在網址直接加上 ui_locales:
當某次互動觸發電郵(例如驗證碼),Logto 會按以下順序決定語言:
ui_locales(第一個支援的標記)Accept-Language 標頭自動偵測然後 Logto 會尋找符合語言及模板類型的自訂電郵模板,若找不到會用連接器的預設。
供應商管理模板(例如 Postmark、HTTP Email):Logto 會把 uiLocales 和 locale 兩個傳給你的供應商。一旦有 ui_locales,locale 也用當中第一個支援的標記。
參見:電郵模板本地化。