跳至主要內容

本地化語言

Logto 支援多種預定義語言，並提供 113 個額外的語言標籤。這個強大的工具讓你可以透過創建和管理自己的語言選項和翻譯來自訂登入體驗。

在 Logto Console 中的自訂步驟​

在 Logto Console 中輕鬆自訂語言設定，無需編碼。

  1. 導航至：Console > Sign-in experience > Content > Languages。
  2. 管理語言：點擊「管理語言」按鈕以訪問你的語言庫。
    • 編輯現有語言：自訂 Logto 提供的語言翻譯。這些語言無法刪除，但你的更改將覆蓋預設值。
    • 新增語言：點擊「新增語言」按鈕，選擇語言標籤，提供你的翻譯，然後儲存更改以新增語言。
  3. 啟用自動檢測：啟用後，根據使用者的設備設定，自動顯示使用者偏好的語言登入頁面。
  4. 設定預設語言：你可以從語言庫中選擇一個預設語言。當檢測到的使用者語言不在當前語言庫中時，將使用此預設語言。

以下是管理語言時需要了解的一些關鍵術語：

定義描述
語言標籤語言標籤識別內容的語言。語言標籤由語言代碼（例如，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 登入體驗的 i18n 使自訂語言成為可能。

點擊 ja 語言標籤以新增你自己的日語翻譯。

這樣，從日本訪問你網站的使用者將能夠閱讀你剛從英文翻譯過來的日文內容。

常見問題​

如果我新增的語言成為 Logto 提供的語言怎麼辦？​

在左側的語言標籤旁邊，將出現一個 Logto 提供的標籤，你新增的語言將不再可移除。修改過的值將繼續運行並替換原始的 Logto 值。刪除使用者提供的值以使用 Logto 預設配置提供的值。

如果我只新增了一些自訂值怎麼辦？​

最終使用者看到的是兩列合併的結果。 假設你只想對 Logto 提供的原始內容副本的某個子集進行調整。你的註冊畫面與 Logto 提供的唯一區別將是你編輯過的鍵。其餘內容將保持不變。

支援阿拉伯語和 RTL（從右到左）語言佈局於你的應用程式中