Aviso de tradução por IA

Esta documentação foi traduzida automaticamente por IA.

I18n Internacionalização

Os plugins do NocoBase suportam internacionalização (i18n) multilíngue tanto no frontend quanto no backend. Com um mecanismo unificado, você pode implementar facilmente conteúdo multilíngue nos seus plugins.

Gerenciamento de Arquivos Multilíngues

Os arquivos multilíngues dos plugins são armazenados de forma padronizada no diretório src/locale. É recomendado nomeá-los pelo idioma, por exemplo:

|- /plugin-hello
  |- /src
    |- /locale
      |- en-US.json   # English language
      |- zh-CN.json   # Chinese language

Cada arquivo de idioma exporta um objeto JSON que contém todas as entradas de tradução para aquele idioma, por exemplo:

// 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}}"
}

Ao adicionar arquivos de idioma pela primeira vez, você precisa reiniciar a aplicação para que eles entrem em vigor. Você pode verificar se as entradas de tradução foram aplicadas através da API: http://localhost:13000/api/app:getLang?locale=zh-CN

APIs Relacionadas ao i18n

ctx.i18n

ctx.t(text, options)

plugin.t()

useT()

tExpr(text)

useTranslation(ns)

withTranslation(ns)