網路小部件語言—— 50 out of the box.

概述—— “支援”的含義

當聊天介面中的每一條使用者可見的文本都經過母語者稽核的翻譯後，該語言即可在網頁小部件中使用。這包括撰寫框佔位符、傳送按鈕提示、連線狀態橫幅、快速回復晶片以及每條錯誤提示訊息。如果某條文本無法直接翻譯（如習語、具有文化特性的表達），稽核過程將編寫適合當地語言環境的改寫內容，而不是回退到英文。

本頁上的列表是實際的執行時表——小部件載入器會發送這些程式碼，並在首次繪製時拉取匹配的包。

一目瞭然的覆蓋範圍

如何檢測訪客的語言

檢測在小元件掛載時執行一次，並按以下順序選擇第一個匹配項：

1. 顯式覆蓋。 如果你的頁面設定 window.Knocket.locale = 'ja' 在小部件載入之前，那個生效。參見 程式碼中覆蓋.
2. HTML lang 屬性。 如果存在 <html lang="fr">，小部件將採用該設定。這是多語言網站最簡潔的選項——可以在伺服器端為每個頁面單獨設定。
3. 瀏覽器語言環境。 回退至 navigator.languages[0]。地區變體將合併為基礎語言（例如 pt-BR → pt）。
4. 英語。 如果上述選項均不匹配已發貨包裹，則元件保持英文顯示，而不會處於部分翻譯狀態。

完整列表 — 50 languages

按全球使用者數量排序。每一行都是一個已釋出的語言包；程式碼列是小部件期望的確切字串。

在程式碼中覆蓋

如果你已經知道訪客的首選語言（來自你的應用狀態、賬戶設定或 URL 引數），請明確告訴小部件：

<script>
  window.Knocket = window.Knocket || {};
  window.Knocket.locale = 'ja'; // must be set before the loader script
</script>
<script src="https://cdn.knocket.ai/w.js" async></script>

或者在小部件載入後，即時更改設定：

Knocket('setLocale', 'zh-Hans');

該元件會重新渲染每個字串，為RTL語言翻轉方向，並保持當前對話完整。

回退行為

兩個值得注意的邊緣情況：

• 未釋出的語言。 如果你傳遞了未知程式碼（例如xx或某個冷僻的地區變體），網頁元件將靜默回退到英文，並在控制台分析中報告該錯誤。
• 區域回退。 當未提供區域包時，區域程式碼會回退到其基礎語言。 pt-BR → pt，en-GB → en。簡體/繁體中文是獨立的包（zh-Hans 與 zh-Hant）——不要將它們別名化。