Phát hiện token
"Khám phá token" là cách SDK tự động xác định nội dung cần dịch, dựa trên cách bạn viết giao diện. Có bốn khối cơ bản, mỗi khối dành cho một dạng nội dung khác nhau.
t() — một chuỗi nội tuyến
Hàm làm việc chính. Gọi hàm này với văn bản gốc và nó trả về bản dịch cho ngôn ngữ hiện tại (hoặc chính văn bản gốc nếu ngôn ngữ đó chưa sẵn sàng). category tùy chọn dùng để nhóm các cụm từ liên quan và được gửi cho công cụ dịch máy làm ngữ cảnh; params điền vào các {placeholders}.
const t = useT();
// t(phrase, category?, params?)
t('Hello, {name}!', 'Greetings', { name });<Translate> — một khối nội dung
Bao quanh một vùng markup và SDK sẽ tách nó thành khối nội dung — mỗi nút văn bản trở thành một cụm từ — rồi dịch lại toàn bộ khối mỗi khi đổi ngôn ngữ. Khối được định danh bằng một id ổn định, tạo ra từ nội dung và danh mục của nó, nên cùng một khối sẽ được nhận diện qua các lần render và tải lại trang.
<Translate category="Home">
<p>Welcome to our store. Browse the catalog in your language.</p>
</Translate><Phrase> — một câu, có markup
Khi một câu chứa markup nội tuyến hoặc nội suy, <Phrase> giữ nó như một đơn vị dịch duy nhất — nhờ vậy "Hi Sarah, you have 3 items" được dịch thành một câu tự nhiên thay vì các mảnh rời rạc. Nó hỗ trợ tham số và dạng số nhiều.
<Phrase category="Cart" params={{ name: 'Sarah', count: 3 }}>
Hi %name%, you have %count% items in your cart.
</Phrase>Ký hiệu giữ chỗ. Hãy viết phép nội suy dưới dạng {name}. Bên trong markup mà framework đã dùng { } (JSX, Vue, Svelte), hãy viết %name% thay thế — SDK sẽ chuẩn hóa lại thành {name} khi ghi nhận cụm từ.
<DontTranslate> — để nguyên, không dịch
Tên thương hiệu, mã, mã định danh, địa chỉ — hãy đánh dấu một vùng để không bao giờ bị dịch. Nó hiển thị translate="no" và hoàn toàn bị bỏ qua khi phát hiện cụm từ.
<p>Welcome! <DontTranslate>This sentence always stays in English.</DontTranslate> Thanks for visiting!</p>Chỉ có thể phát hiện cụm từ khi dùng khóa ghi. Trên trình duyệt, bạn phát hành khóa chỉ đọc, nên SDK sẽ không đăng ký bất cứ thứ gì — nó chỉ tải các bản dịch đã có sẵn. Việc đăng ký là hoạt động diễn ra trong giai đoạn phát triển. Xem Khóa & môi trường.