简体中文
通过 OIDC ui_locales 本地化你的 Logto 登录体验
让你的登录体验对每位用户都像原生应用。在本教程中,你将学习如何使用标准 OIDC 参数 ui_locales 设置 Logto 登录界面及相关邮件的运行时语言。
让你的登录体验对每位用户都像原生应用。在本教程中,你将学习如何使用标准 OIDC 参数 ui_locales 设置 Logto 登录界面及相关邮件的运行时语言。
Logto 已经支持多语言内容和自动检测,但有些场景你可能想为某个具体交互明确选择语言:
此外,ui_locales 是许多身份提供商和 SDK 支持的标准参数。
uiLocales 暴露给邮件模板(例如:“请求的语言:{{uiLocales}}”)参考文档查看更多:界面本地化文档。
可选但很实用:
Logto SDK 支持在登录时传递额外的 OIDC 参数。将 ui_locales 加入 extraParams:
注意:
fr-CA,否则 fr,再否则 en)。ui_locales 和其它标准/自定义参数组合使用(如 login_hint、organization_id 或首屏指令等)。如果你手动拼装 OIDC 授权请求(或使用通用 OIDC 客户端),可以直接添加 ui_locales:
当某次交互触发邮件(例如验证码)时,Logto 按如下优先级解析语言:
ui_locales(首先支持的 tag)Accept-Language 头自动检测随后 Logto 会尝试查找与已解析语言和模板类型匹配的自定义邮件模板;如未找到,则回退到连接器默认模板。
由服务商托管的模板(如 Postmark、HTTP Email):Logto 会同时传递 uiLocales 和 locale 给你的服务商。如果 ui_locales 存在,locale 会使用 ui_locales 的第一个支持标签。
详见:邮件模板本地化。