Ngôn ngữ của Tiện ích web — 50 out of the box.

Tổng quan — "được hỗ trợ" nghĩa là gì

Một ngôn ngữ sẽ được đưa vào Tiện ích web khi mọi chuỗi hiển thị cho người dùng trong giao diện trò chuyện đều có bản dịch được người bản ngữ duyệt. Điều này bao gồm văn bản giữ chỗ trong ô soạn thảo, chú giải của nút gửi, biểu ngữ trạng thái kết nối, các nút trả lời nhanh và mọi thông báo lỗi. Nếu một chuỗi không thể được dịch tương đương trực tiếp (thành ngữ, cách diễn đạt đặc thù văn hóa), bản duyệt sẽ được viết lại cho phù hợp với ngôn ngữ địa phương thay vì dùng tiếng Anh.

Danh sách trên trang này chính là bảng thời gian chạy thực tế — trình tải tiện ích cung cấp các mã này và tải gói tương ứng trong lần hiển thị đầu tiên.

Tổng quan về phạm vi hỗ trợ

Cách phát hiện ngôn ngữ của khách truy cập

Quá trình phát hiện chạy một lần khi tiện ích được gắn và chọn kết quả khớp đầu tiên theo thứ tự sau:

1. Ghi đè rõ ràng. Nếu trang của bạn thiết lập window.Knocket.locale = 'ja' trước khi tiện ích tải xong, lựa chọn đó sẽ được ưu tiên. Xem Ghi đè trong mã.
2. Thuộc tính lang của HTML. Nếu có <html lang="fr">, tiện ích sẽ sử dụng thuộc tính này. Đây là lựa chọn tối ưu nhất cho các trang web đa ngôn ngữ — hãy thiết lập thuộc tính này ở phía máy chủ cho từng trang.
3. Ngôn ngữ của trình duyệt. Nếu không xác định được, hệ thống sẽ sử dụng navigator.languages[0]. Các biến thể theo khu vực được quy về ngôn ngữ cơ sở (ví dụ: pt-BR → pt).
4. Tiếng Anh. Nếu không có tùy chọn nào ở trên khớp với một gói đã phát hành, tiện ích sẽ giữ nguyên tiếng Anh thay vì ở trạng thái chỉ được dịch một phần.

Danh sách đầy đủ — 50 languages

Được xếp hạng theo tổng số người nói trên toàn cầu. Mỗi hàng là một gói ngôn ngữ đã phát hành; cột mã là chuỗi chính xác mà tiện ích yêu cầu.

Ghi đè trong mã

Nếu bạn đã biết ngôn ngữ ưu tiên của khách truy cập (từ trạng thái ứng dụng, cài đặt tài khoản hoặc tham số URL), hãy chỉ định rõ cho tiện ích:

<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>

Hoặc sau khi tiện ích đã được gắn, hãy thay đổi trực tiếp:

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

Tiện ích hiển thị lại mọi chuỗi, chuyển hướng cho các ngôn ngữ RTL và giữ nguyên cuộc trò chuyện hiện tại.

Cơ chế dự phòng

Hai trường hợp đặc biệt đáng lưu ý:

• Ngôn ngữ chưa được phát hành. Nếu bạn truyền một mã không xác định (ví dụ: xx hoặc một biến thể khu vực ít phổ biến), tiện ích sẽ âm thầm chuyển về tiếng Anh và báo cáo trường hợp không khớp trong phần phân tích của bảng điều khiển.
• Phương án dự phòng theo khu vực. Mã khu vực sẽ được rút gọn về ngôn ngữ cơ sở khi không có gói khu vực tương ứng. pt-BR → pt, en-GB → en. Tiếng Trung giản thể và phồn thể là các gói riêng biệt (zh-Hans và zh-Hant) — không được đặt chúng làm bí danh của nhau.