本地化语言
Logto 支持多种预定义语言,并提供 113 个附加语言标签。这个强大的工具允许你通过创建和管理自己的语言选项和翻译来定制登录体验。
在 Logto 控制台中的自定义步骤
在 Logto 控制台中轻松自定义语言设置,无需编码。
- 导航到:控制台 > 登录体验 > 内容 > 语言。
- 管理语言:点击“管理语言”按钮以访问你的语言库。
- 编辑现有语言:自定义 Logto 提供的语言的翻译。这些语言不能被删除,但你的更改将覆盖默认值。
- 添加新语言:点击“添加语言”按钮,选择一个语言标签,提供你的翻译,然后保存更改以添加新语言。
- 启用自动检测:启用后,将根据用户设备设置自动以用户的首选语言显示登录页面。
- 设置默认语言:你可以从语言库中选择一种默认语言。当检测到的用户语言不在当前语言库中时,将使用默认语言。
以下是管理语言时需要了解的一些关键术语:
定义 | 描述 |
---|---|
语言标签 | 语言标签标识内容的语言。语言标签由语言代码(例如,en, fr, zh)和国家/地区代码(例如,US, UK, KR)组成,用连字符分隔。语言标签看起来像这样:en-US。 |
Logto 提供的语言 | Logto 提供的语言是 Logto 官方语言,存储在 Logto 原始代码库中。 |
添加的语言 | 添加的语言是用户添加的语言。 |
Logto 源值 | Logto 源值是 Logto 提供的尚未被用户自定义的值。 |
自定义值 | 自定义值是已经被用户自定义的值。Logto 源值将被覆盖。 |
使用 Management API 进行自定义
你可以使用 Management API PUT /api/custom-phrases/{languageTag} 来自定义语言翻译。API 请求体是一个部分本地化对象,如下所示:
{
"input": { "username": "Username", "password": "Password" },
"secondary": {
"social_bind_with": "Already had an account? Sign in to link {{methods, list(type: disjunction;)}} with your social identity."
},
"action": { "sign_in": "Sign in" },
"error": {
"general_required": "{{types, list(type: disjunction;)}} is required"
},
"list": { "or": "or" },
"user_scopes": {
"descriptions": { "custom_data": "Your custom data" }
}
}
请参考源代码以查看所有可自定义的内容。
你还可以使用 PATCH /api/sign-in-exp API 来控制语言检测策略。
使用案例
添加的语言如何呈现给终端客户?
假设你有一个网站,默认语言是英语,并且启用了自动检测。一个来自日本的用户偶然访问了你的网站,并决定创建一个账户。如果他/她使用日语作为应用程序语言,但 Logto 尚不支持该语言,登录屏幕将以英语显示。
Logto 登录体验的国际化使自定义语言成为可能。
点击 ja
语言标签以添加你自己的日语翻译。
这样,从日本访问你网站的用户将能够阅读你刚刚从英语翻译过来的日语内容。
常见问题解答
如果我添加的语言成为 Logto 提供的语言怎么办?
在左侧的语言标签旁边,将出现一个 Logto 提供的标签,你添加的语言将不再可移除。修改后的值将继续生效并替换原始 Logto 值。擦除用户提供的值以使用 Logto 默认配置提供的值。
如果我只添加了一些自定义值怎么办?
最终用户看到的是两列合并的结果。 假设你只想对 Logto 提供的原始内容副本的一个子集进行调整。你编辑的键将是你的注册屏幕与 Logto 提供的屏幕之间的唯一区别。其余内容将保持不变。
相关资源
在你的应用程序中支持阿拉伯语和 RTL(从右到左)语言布局