繁體中文(台灣)
使用 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 用戶端)構建 OIDC 授權請求,直接加上 ui_locales:
當一次互動會觸發郵件(例如驗證碼)時,Logto 會依下列順序決定語言:
ui_locales(第一個支援標籤)Accept-Language 標頭然後 Logto 會嘗試尋找一個符合解析語言與模板類型的自訂郵件模板;如果找不到,則退回到連接器預設值。
由供應者管理的模板(例如 Postmark、HTTP Email):Logto 會同時將 uiLocales 和 locale 傳遞給你的供應者。如果有 ui_locales,locale 就會使用 ui_locales 中第一個支援的標籤。
詳見:郵件模板本地化。