웹 위젯 언어 — 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 vs zh-Hant)이며, 별칭 처리하지 마세요.