Языки веб-виджета — 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');

Виджет заново отображает каждую строку, меняет направление текста для языков с письмом справа налево и сохраняет текущий диалог без изменений.

Резервное поведение

Стоит отметить два особых случая:

• Неподдерживаемая локаль. Если вы передадите неизвестный код (например, xx или редкий региональный вариант), виджет автоматически переключится на английский язык и зарегистрирует этот случай в аналитике консоли.
• Региональный резервный вариант. Если региональный языковой пакет отсутствует, региональные коды сводятся к базовому языку. pt-BR → pt, en-GB → en. Упрощённый и традиционный китайский представлены отдельными пакетами (zh-Hans и zh-Hant) — не связывайте их как псевдонимы.