网络聊天组件语言—— 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）——不要将它们别名化。