JavaScript e React

Traduza conteúdo no servidor, renderize catálogos de mensagens no React e conecte o roteamento por idioma à sua aplicação.

Aplicações JavaScript usam tradução em dois pontos. O servidor envia conteúdo a um engine de localização e armazena o resultado. A interface carrega as mensagens traduzidas e as renderiza com os valores, a gramática e a formatação corretos. Escolha o pacote para a parte que você está desenvolvendo.

Traduzir a partir do seu servidor #

Use o guia da API JavaScript para criar tarefas de tradução com fetch nativo, acompanhar o progresso e baixar os arquivos concluídos. Mantenha a chave de API no servidor e preserve o identificador de cada tarefa junto à revisão do conteúdo de origem que ela traduz.

Aplicações que usam LingoDotDevEngine contam com uma referência do SDK v0 separada. A API síncrona e o processamento em lotes no lado do cliente continuam documentados nela.

Renderizar mensagens no React #

O React mantém a mensagem de origem e seu 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 renderização não exige uma chave de API de tradução.

Comece com um componente traduzido, usando um catálogo local. Depois, extraia e carregue catálogos conforme a aplicação crescer. Os guias de Next.js Pages e TanStack Start conectam esses catálogos às requisições, às rotas e à troca de idioma. Se você usa um roteador próprio, o locale-router fornece a lógica por trás das decisões sobre URLs e preferências de idioma.

Conectar uma aplicação Payload #

O plugin do Payload CMS expõe o esquema de campos e notifica o Lingo.dev quando o conteúdo de origem muda. A integração com o Payload configura qual conteúdo traduzir e onde gravar a tradução de volta.

Projetos de exemplo #

Estes repositórios mostram como os arquivos de origem e o carregamento da aplicação se integram. Confira as versões das dependências e a configuração de cada projeto antes de adaptá-lo; alguns usam uma geração do pacote diferente da abordada nestes manuais. Ao criar um fork, conecte seu próprio projeto do Lingo.dev antes de enviar 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 que levam o idioma em conta.
Módulos TypeScriptDados estáticos de idioma exportados. Use a estrutura de exportação padrão aceita pelo processador de TypeScript; exportações não compatíveis podem não gerar nenhuma unidade de tradução.
iOSRecursos da Apple e seleção nativa de idioma.
AndroidDiretórios de recursos e busca de strings.
FlutterMetadados ARB e mensagens geradas.
MarkdownCaminhos de documentos e metadados de cabeçalho.
Markdoc + Next.jsPropriedades traduzíveis de tags e renderização de documentos.
OpenAPIDescrições legíveis por pessoas em uma especificação de API.
RailsYAML com o idioma na raiz e busca pelo framework.
LaravelArquivos de recursos e carregamento pelo framework.

Recursos nativos e documentos usam a CLI e seus respectivos processadores de formato. Eles não precisam do ambiente de execução do React só por estarem nesta coleção de exemplos.