#I18n (Quốc tế hóa)

Các plugin của NocoBase hỗ trợ quốc tế hóa đa ngôn ngữ (i18n) cho cả giao diện người dùng (frontend) và phía máy chủ (backend). Với một cơ chế thống nhất, bạn có thể dễ dàng triển khai nội dung đa ngôn ngữ trong các plugin.

#Quản lý tệp đa ngôn ngữ

Các tệp đa ngôn ngữ của plugin được lưu trữ thống nhất trong thư mục src/locale. Bạn nên đặt tên các tệp này theo ngôn ngữ, ví dụ:

|- /plugin-hello
  |- /src
    |- /locale
      |- en-US.json   # Ngôn ngữ tiếng Anh
      |- zh-CN.json   # Ngôn ngữ tiếng Trung

Mỗi tệp ngôn ngữ xuất một đối tượng JSON chứa tất cả các mục dịch cho ngôn ngữ đó, ví dụ:

// zh-CN.json
{
  "Hello": "你好",
  "World": "世界",
  "Enter your name": "请输入你的名字",
  "Your name is {{name}}": "你的名字是 {{name}}"
}

// en-US.json
{
  "Hello": "Hello",
  "World": "World",
  "Enter your name": "Enter your name",
  "Your name is {{name}}": "Your name is {{name}}"
}

Khi thêm tệp ngôn ngữ lần đầu, bạn cần khởi động lại ứng dụng để các thay đổi có hiệu lực. Bạn có thể kiểm tra xem các mục dịch đã có hiệu lực hay chưa thông qua API:
http://localhost:13000/api/app:getLang?locale=zh-CN

#Các API liên quan đến i18n

#ctx.i18n

#ctx.t(text, options)

#plugin.t()

#useT()

#tExpr(text)

#useTranslation(ns)

#withTranslation(ns)