Khái niệm cốt lõi

18ways có quan điểm rõ ràng về một vài điều. Khi những điều này đã rõ, phần còn lại của bề mặt API trở nên đơn giản.

Ngôn ngữ cơ sở

baseLocale của bạn là ngôn ngữ mà bạn viết bằng.

Nếu nội dung mô tả sản phẩm của bạn được viết bằng tiếng Anh Anh, thì ngôn ngữ cơ sở của bạn là en-GB. Nếu nó được viết bằng tiếng Anh Mỹ, thì ngôn ngữ cơ sở của bạn là en-US.

Khi ngôn ngữ hiện tại trùng với ngôn ngữ gốc, 18ways trả về ngay văn bản nguồn và bỏ qua công việc dịch thuật.

Ngôn ngữ đích

Ngôn ngữ đích của bạn là ngôn ngữ mà người dùng hiện đang đọc.

Trong React, bạn thường giữ nó trong state và truyền nó tới Ways gốc.

Ngữ cảnh

Ngữ cảnh là cách 18ways nhóm các đoạn nội dung liên quan.

Hãy dùng chúng để giữ cho các yêu cầu dịch ngắn gọn và tránh trộn lẫn những đoạn văn bản không liên quan với nhau.

tsx
import { Ways } from '@18ways/react';
 
export function AppRoot() {
  return (
    <Ways apiKey="pk_dummy_demo_token" locale="fr-FR" baseLocale="en-GB" context="marketing">
      <Ways context="hero">
        <Hero />
      </Ways>
      <Ways context="pricing">
        <Pricing />
      </Ways>
    </Ways>
  );
}

Các phạm vi Ways lồng nhau kết hợp thành một đường dẫn ngữ cảnh. marketing cộng với hero sẽ thành marketing.hero.

Ngôn ngữ được chấp nhận

18ways phân biệt giữa:

  • một ngôn ngữ vùng mà nó có thể nhận ra, như fr-FR
  • một ngôn ngữ mà dự án của bạn thực sự chấp nhận

Runtime có thể lấy danh sách locale được chấp nhận từ API, rồi chuẩn hoá các giá trị locale đầu vào so với danh sách đó.

tsx
import { Ways } from '@18ways/react';
 
export function AppRoot() {
  return (
    <Ways
      apiKey="pk_dummy_demo_token"
      locale="fr-FR"
      baseLocale="en-GB"
      acceptedLocales={['en-GB', 'fr-FR', 'de-DE']}
      context="app"
    >
      <App />
    </Ways>
  );
}

Sự kiên trì

Cookie tùy chọn ngôn ngữ được runtime sử dụng là 18ways_locale.

Khi bản dịch được tải

@18ways/react có thể tạm ngưng trong khi một ngữ cảnh được gieo hạt đang phân giải và giữ một bộ nhớ đệm dùng chung trong bộ nhớ trên phía máy khách.

Mô hình tinh thần chung

Giữ mô hình đơn giản:

  1. Chọn gói phù hợp cho ứng dụng của bạn.
  2. Thiết lập đúng ngôn ngữ cơ sở.
  3. Giữ cho các khóa ngữ cảnh ổn định và có ý nghĩa.
  4. Hãy để runtime dịch các cụm từ hoàn chỉnh, không phải các mảnh rời.

Tiếp theo: Định dạng tin nhắn

Khái niệm cốt lõi