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.
| 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 que levam o idioma em conta. |
| Módulos TypeScript | Dados 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. |
| iOS | Recursos da Apple e seleção nativa de idioma. |
| Android | Diretórios de recursos e busca de strings. |
| Flutter | Metadados ARB e mensagens geradas. |
| Markdown | Caminhos de documentos e metadados de cabeçalho. |
| Markdoc + Next.js | Propriedades traduzíveis de tags e renderização de documentos. |
| OpenAPI | Descrições legíveis por pessoas em uma especificação de API. |
| Rails | YAML com o idioma na raiz e busca pelo framework. |
| Laravel | Arquivos 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.