Como traduzir JSON

Traduzir JSON com nosso serviço é simples e eficiente. Siga as etapas abaixo para traduzir enquanto garante a precisão e mantém a integridade da sua estrutura JSON.

1. Cole seu JSON: Na seção "Strings de origem", cole seu conteúdo JSON. Certifique-se de que o JSON seja válido e esteja formatado corretamente. Nosso serviço suporta objetos JSON profundamente aninhados, preservando sua estrutura durante a tradução.
2. Definir idioma de destino: Insira o idioma de destino (por exemplo, 'fr-FR') para tradução.
3. Iniciar tradução: Clique no botão "Traduzir" para começar. Nosso serviço processa cuidadosamente a estrutura JSON, preservando chaves e formatação enquanto traduz valores.
4. Copiar ou salvar: Após a conclusão da tradução, você pode copiar o JSON traduzido para sua área de transferência ou salvá-lo como um arquivo. O arquivo salvo usará automaticamente o código do idioma de destino como seu nome, garantindo fácil identificação e organização.

O que é JSON e por que ele é usado para localização?

JSON (JavaScript Object Notation) é um formato de intercâmbio de dados leve e legível por humanos que organiza dados como pares de chave-valor e objetos aninhados. Projetado originalmente para troca de dados em JavaScript, o JSON é agora um formato universal suportado nativamente por todas as principais linguagens de programação, tempo de execução e navegador.

O JSON tornou-se o formato dominante para localização de aplicativos web e móveis devido à sua simplicidade, suporte nativo a navegadores e integração profunda com o ecossistema JavaScript. Bibliotecas como i18next, React Intl, ngx-translate, Vue i18n e next-i18next usam JSON como seu formato de arquivo de tradução principal ou padrão.

Um arquivo de localização JSON armazena strings como pares de chave-valor aninhados, onde as chaves servem como identificadores referenciados no código e os valores contêm o texto legível por humanos exibido aos usuários em um idioma específico.

Estrutura de arquivo i18n JSON

Um arquivo de localização JSON bem estruturado organiza strings hierarquicamente usando objetos aninhados. Aqui está um exemplo típico:

{
  "greeting": "Hello, World!",
  "user": {
    "name": "John Doe",
    "welcome": "Welcome back, {{name}}!"
  },
  "nav": {
    "home": "Home",
    "about": "About Us",
    "contact": "Contact"
  }
}

• Chaves de string — identificadores legíveis por humanos que referenciam a tradução no código (por exemplo, t('nav.home')). As chaves nunca são traduzidas; apenas os valores de string são.
• Objetos aninhados — agrupar strings relacionadas sob um namespace compartilhado (por exemplo, auth, errors) mantém arquivos grandes organizados e fáceis de manter entre as equipes.
• Espaços reservados de interpolação — variáveis como {{name}} ou {{count}} são incorporadas em valores de string. Nossa IA detecta e preserva todos os formatos de espaço reservado durante a tradução.
• Chaves de forma plural — o i18next usa sufixos de chave especiais (_one, _other, _few, _many) para lidar com regras de pluralização específicas do idioma. Nosso serviço reconhece esses padrões e gera as formas corretas para cada idioma de destino.
• HTML inline e caracteres especiais — as strings podem conter tags HTML inline ou caracteres escapados. Nossa IA preserva toda a marcação e escape exatamente como no arquivo de origem.

Exemplo de arquivo de localização JSON (i18next)

Aqui está um arquivo de localização JSON compatível com i18next do mundo real mostrando namespaces, interpolação e chaves de forma plural:

{
  "app": {
    "title": "My Application",
    "description": "A powerful tool for your workflow"
  },
  "auth": {
    "login": "Log in",
    "logout": "Log out",
    "welcome": "Welcome, {{name}}!",
    "itemCount_one": "{{count}} item",
    "itemCount_other": "{{count}} items"
  },
  "errors": {
    "notFound": "Page not found",
    "serverError": "Something went wrong. Please try again."
  }
}

Esta estrutura é diretamente compatível com i18next, React Intl, next-i18next e ngx-translate. O mesmo arquivo pode ser usado como origem para traduzir para francês, alemão, japonês ou qualquer outro idioma de destino usando nosso serviço.

JSON em fluxos de trabalho i18n modernos

Arquivos de localização JSON são a base da maioria dos fluxos de trabalho modernos de internacionalização (i18n). A flexibilidade do formato suporta estruturas simples de chave-valor planas para pequenos projetos e hierarquias profundamente aninhadas e com namespaces para aplicativos de escala empresarial com centenas de chaves de tradução.

Como os arquivos JSON são texto simples, eles se integram naturalmente a sistemas de controle de versão como Git, pipelines de CI/CD e plataformas de gerenciamento de tradução. As equipes podem automatizar todo o pipeline de localização — desde a extração de novas strings até a implantação de builds traduzidos — usando a API REST do L10n.dev.

Frameworks e bibliotecas que usam JSON para localização

Arquivos de tradução JSON são suportados por praticamente todos os principais frameworks web e móveis:

• i18next / react-i18next — a biblioteca i18n JavaScript mais utilizada. Usa arquivos JSON organizados por idioma e namespace (por exemplo, public/locales/en/common.json). Suporta interpolação, plurais, contexto e aninhamento nativamente.
• next-i18next — a solução i18n padrão para aplicativos Next.js. Construída sobre o i18next, usa arquivos JSON no diretório public/locales/ e suporta renderização no lado do servidor com detecção automática de localidade.
• Angular (ngx-translate) — a popular biblioteca ngx-translate carrega arquivos de tradução JSON e fornece um pipe e serviço translate para aplicativos Angular. Suporta troca de idioma em tempo de execução sem recarregar o aplicativo.
• Vue i18n — o plugin oficial i18n do Vue.js suporta arquivos de mensagem JSON. O JSON é comumente preferido para geração programática e fluxos de trabalho de localização orientados por API em projetos Vue 3 e Nuxt.js.
• Flutter / Dart (ARB) — o pacote intl do Flutter usa arquivos ARB (Application Resource Bundle), que são arquivos JSON com metadados de localização. O comando flutter gen-l10n os compila em código Dart fortemente tipado.
• React Native — aplicativos React Native usam react-i18next ou i18n-js com arquivos de tradução JSON para localização multiplataforma iOS e Android a partir de um único recurso compartilhado.

Geração de glossário por IA para traduções JSON

Nosso recurso de geração de glossário por IA ajuda você a manter uma terminologia consistente em todos os seus arquivos de localização JSON. Habilite o salvamento e a reutilização alternando gerar e salvar glossário nas opções de tradução:

• Terminologia consistente — a IA analisa seu JSON de origem e as traduções de destino existentes para criar um glossário de termos-chave, garantindo que nomes de produtos, rótulos de UI e termos técnicos sejam traduzidos da mesma maneira em todo o seu aplicativo.
• Termos específicos do domínio — forneça uma amostra de conteúdo JSON já traduzido no campo de strings de destino. A IA aprende sua terminologia preferida e a aplica a novas strings automaticamente.
• Como usar — cole seu conteúdo JSON traduzido no campo opcional de strings de destino que aparece quando a geração de glossário está habilitada. A IA extrairá termos recorrentes e os usará como um guia de tradução. Se nenhuma string de destino for fornecida, a IA gera entradas do glossário apenas a partir do conteúdo de origem, o que ainda pode melhorar a consistência.

Por que nosso serviço de tradução JSON

• Tradução contextual com tecnologia de IA: Nossa IA avançada entende estruturas JSON, lida com placeholders perfeitamente e adapta as traduções para nuances culturais do idioma de destino.
• Tradução i18next: Nosso serviço suporta totalmente arquivos JSON no formato i18next. Ele garante o tratamento preciso de formas plurais, preserva tags HTML e quebras de linha, e mantém a integridade de suas traduções, tornando-o ideal para fluxos de trabalho de localização.
• Ajustes específicos de localidade: Converte automaticamente números, datas e outros dados sensíveis à localidade para corresponder ao formato da região de destino.
• Tratamento de erros: Detecta e corrige erros de tradução por IA, garantindo resultados consistentemente de alta qualidade.
• Custo-benefício: Aproveite preços acessíveis com 10,000 caracteres gratuitos mensalmente.Ver preços
• Otimizado para grandes conteúdos JSON: Processe arquivos JSON grandes de forma eficiente dividindo-os em partes gerenciáveis, garantindo consistência de tradução com terminologia e contexto predefinidos.

Tradução JSON vs. Outros Formatos

A tradução JSON foca na adaptação de pares chave-valor para um idioma e região específicos, preservando a estrutura. Nosso serviço garante que o JSON traduzido permaneça válido e pronto para uso em seus aplicativos.

Nosso serviço foca na tradução de arquivos JSON usando tradução por IA, garantindo precisão e eficiência enquanto gerencia a estrutura do arquivo JSON.

Casos de uso comuns de localização JSON

Arquivos de tradução JSON são usados em uma ampla gama de tipos de projetos e fluxos de trabalho de desenvolvimento:

• Aplicativos React e Next.js — traduza public/locales/en/common.json e outros arquivos de namespace para SPAs React e aplicativos Next.js usando react-i18next ou next-i18next.
• Aplicativos Angular — traduza arquivos JSON do ngx-translate para adicionar suporte a vários idiomas a painéis corporativos Angular e aplicativos de página única.
• Aplicativos Vue.js / Nuxt.js — localize arquivos de mensagem JSON do Vue i18n para aplicativos de página única Vue 3 e sites renderizados no servidor Nuxt.js.
• Aplicativos React Native — traduza arquivos de localização JSON para aplicativos móveis iOS e Android multiplataforma criados com React Native e react-i18next.
• Aplicativos de desktop (Electron) — aplicativos Electron usam arquivos de localização JSON com i18next ou carregadores personalizados para entregar software de desktop em vários idiomas.
• CI/CD e pipelines automatizados — integre a tradução JSON ao seu fluxo de trabalho de lançamento usando a API REST do L10n.dev para automatizar a localização como parte do seu pipeline de CI/CD.
• Headless CMS e sites estáticos — traduza exportações de conteúdo JSON de plataformas headless CMS como Contentful, Sanity ou Strapi para sites estáticos multilíngues criados com Gatsby, Next.js ou Astro.

Importante: Trabalhando com arrays em JSON

Ao usar "traduzir apenas strings novas": Se o seu JSON contiver arrays (não apenas objetos), certifique-se de que os índices do array no seu arquivo de destino correspondam aos do arquivo de origem. Isso garante que as traduções permaneçam consistentes. Ao adicionar novas strings, sempre anexe-as ao final do array.

Exemplo:

// ✅ CORRECT: New items added at the end
// source.json
["Apple", "Banana", "Orange"]

// target.json (existing)
["Manzana", "Plátano"]

// After translation (new item appended)
["Manzana", "Plátano", "Naranja"]

// ❌ INCORRECT: Items inserted in the middle
// This will cause misalignment!
["Apple", "Cherry", "Banana", "Orange"]

Para estruturas JSON baseadas em objetos (recomendado para i18n), isso não é uma preocupação, pois as traduções são correspondidas por nomes de chaves.

Perguntas frequentes

O que é preservado durante a tradução de JSON?

Todas as chaves JSON, aninhamento estrutural, placeholders de interpolação ({{variable}}, {variable}), tags HTML embutidas, caracteres escapados e sufixos de chaves plurais são preservados. Apenas os valores de texto legíveis por humanos são traduzidos.

Placeholders de interpolação como {{name}} serão mantidos intactos?

Sim. Nossa IA detecta e preserva automaticamente todos os formatos de interpolação comuns usados pelo i18next ({{variable}}), React Intl ({variable}), Vue i18n ({variable}) e outros. Os nomes e a sintaxe dos placeholders permanecem exatamente como no arquivo de origem.

O serviço suporta estruturas JSON profundamente aninhadas?

Sim. Nosso serviço lida com aninhamento JSON arbitrariamente profundo. Cada valor de texto é traduzido com conhecimento de seu caminho hierárquico, e o JSON de saída mantém exatamente a mesma estrutura do arquivo de entrada.

Como as formas plurais do i18next são tratadas?

Nossa IA reconhece sufixos de chaves plurais do i18next (_one, _other, _zero, _few, _many) e gera as formas plurais corretas para o idioma de destino. Traduzir para um idioma como polonês ou árabe produzirá automaticamente todas as entradas de formas plurais necessárias.

E se meu arquivo JSON for muito grande?

Para arquivos JSON muito grandes (centenas de kilobytes), recomendamos usar a página de Tradução de Arquivos i18n, que suporta uploads de arquivos de até 5 MB, oferece entrega mais confiável para grandes conteúdos e permite a tradução para vários idiomas de destino ao mesmo tempo.