JavaScript e React

Traduza conteúdo num servidor, apresente catálogos de mensagens em React e ligue o encaminhamento por idioma à sua aplicação.

As aplicações JavaScript recorrem à tradução em dois pontos. O servidor envia conteúdo para um motor de localização e guarda o resultado. A interface de utilizador carrega as mensagens traduzidas e apresenta-as com os valores, a gramática e a formatação corretos. Escolha o pacote adequado à parte que está a desenvolver.

Traduza a partir do seu servidor #

Utilize o guia da API JavaScript para criar tarefas de tradução com fetch nativo, acompanhar o progresso e descarregar os ficheiros concluídos. Mantenha a chave de API no servidor e guarde o identificador de cada tarefa juntamente com a revisão de origem que essa tarefa traduz.

As aplicações que utilizam LingoDotDevEngine dispõem de uma Referência do SDK v0 própria. A API síncrona e o processamento em lote no lado do cliente continuam documentados nessa referência.

Apresente mensagens em React #

O React mantém a mensagem de origem e o respetivo contexto no componente. Um catálogo fornece o modelo traduzido; o ambiente de execução insere os valores e cria os elementos React controlados pela sua aplicação. A apresentação das mensagens não requer uma chave de API de tradução.

Comece por um componente traduzido, com um catálogo local. Depois, extraia e carregue catálogos à medida que a aplicação cresce. Os guias práticos de Next.js Pages e TanStack Start ligam esses catálogos aos pedidos, às rotas e à mudança de idioma. Se utilizar um sistema de encaminhamento próprio, o locale-router fornece a lógica de decisão subjacente aos URL e às preferências de idioma.

Ligue uma aplicação Payload #

O plugin do Payload CMS disponibiliza o esquema dos campos e notifica o Lingo.dev quando o conteúdo de origem muda. A integração com o Payload permite configurar o conteúdo a traduzir e onde voltar a guardá-lo.

Projetos de exemplo #

Estes repositórios mostram como os ficheiros de origem se articulam com o carregamento da aplicação. Consulte as versões das dependências e a configuração de cada projeto antes de o adaptar: alguns utilizam uma geração de pacotes diferente da descrita nestes manuais. Numa cópia derivada do repositório, ligue o seu próprio projeto Lingo.dev antes de submeter tarefas de tradução.

ProjetoPonto de partida útil
React + ViteMensagens de componentes, extração e carregamento de catálogos.
Next.js PagesMensagens de páginas e rotas adaptadas ao idioma.
Módulos TypeScriptDados estáticos de idioma exportados. Utilize a estrutura de exportação predefinida suportada pelo manipulador de TypeScript; as exportações não suportadas podem não gerar unidades de tradução.
iOSRecursos Apple e seleção nativa de idioma.
AndroidDiretórios de recursos e pesquisa de cadeias de texto.
FlutterMetadados ARB e mensagens geradas.
MarkdownCaminhos de documentos e metadados iniciais.
Markdoc + Next.jsPropriedades traduzíveis de etiquetas e apresentação de documentos.
OpenAPIDescrições legíveis por pessoas numa especificação de API.
RailsYAML com o idioma na raiz e pesquisa pela infraestrutura de desenvolvimento.
LaravelFicheiros de recursos e carregamento pela infraestrutura de desenvolvimento.

Os recursos nativos e os documentos utilizam a CLI e os respetivos processadores de formatos. O simples facto de constarem desta coleção de exemplos não significa que precisem do ambiente de execução do React.