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.
| Projeto | Ponto de partida útil |
|---|---|
| React + Vite | Mensagens de componentes, extração e carregamento de catálogos. |
| Next.js Pages | Mensagens de páginas e rotas adaptadas ao idioma. |
| Módulos TypeScript | Dados 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. |
| iOS | Recursos Apple e seleção nativa de idioma. |
| Android | Diretórios de recursos e pesquisa de cadeias de texto. |
| Flutter | Metadados ARB e mensagens geradas. |
| Markdown | Caminhos de documentos e metadados iniciais. |
| Markdoc + Next.js | Propriedades traduzíveis de etiquetas e apresentação de documentos. |
| OpenAPI | Descrições legíveis por pessoas numa especificação de API. |
| Rails | YAML com o idioma na raiz e pesquisa pela infraestrutura de desenvolvimento. |
| Laravel | Ficheiros 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.