Webウィジェット言語 — 50 out of the box.

概要 — 「サポートされている」の意味

Webウィジェットに言語が搭載されるのは、チャットUI内のすべてのユーザーに表示される文字列がネイティブスピーカーによってレビュー済みの翻訳を持っている場合です。これには、入力欄のプレースホルダー、送信ボタンのツールチップ、接続状態バナー、クイック返信チップ、およびすべてのエラートーストが含まれます。もし文字列が直接的な訳語（慣用句、文化的表現など）で翻訳できない場合、レビュープロセスでは英語にフォールバックせず、そのロケールに適した表現に書き換えます。

このページのリストは実際のランタイムテーブルです — ウィジェットローダーはこれらのコードを送信し、最初の描画時に一致するパックを取得します。

一目でわかるカバレッジ

訪問者の言語の検出方法

ウィジェットのマウント時に1回だけ検出が実行され、この順序で最初に一致したものを選びます：

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言語の方向を反転させ、現在の会話をそのまま保持します。

フォールバック動作

注目に値する2つのエッジケース：

• 未出荷のロケール。 未知のコード（例：xx または珍しい地域バリアント）を渡すと、ウィジェットは英語に静かにフォールバックし、コンソール分析でエラーを報告します。
• 地域フォールバック。地域コードは、地域パックが提供されていない場合、基本言語に折りたたまれます。pt-BR → pt、en-GB → en。簡体字中国語／繁体字中国語は別々のパック（zh-Hans と zh-Hant）で、エイリアス化しないでください。