Como traduzir a interface de um aplicativo web

Como traduzir a interface de um aplicativo web

Última atualização: 12 de setembro de 2026

Para traduzir a interface de um aplicativo web, você tem duas opções de verdade. Extrair cada string para arquivos de localidade que acompanham o app ou executar uma camada sobre o DOM renderizado que substitui o texto conforme ele aparece. A maioria das equipes acaba usando um pouco de cada opção, e qual delas dá mais trabalho depende de quanto da sua interface é texto do produto e quanto é conteúdo.

Este guia é sobre telas de aplicativos, não páginas de destino: painéis, configurações, formulários, botões, estados vazios, mensagens de erro e os e-mails enviados pelo seu app. Os modos de falha são diferentes, e a maioria das recomendações sobre “traduzir um site” não funciona quando aplicada à interface de um produto de verdade.

Vale a pena fazer esse esforço. A CSA Research entrevistou 8.709 consumidores em 29 países e descobriu que 40% nunca comprarão em sites em outros idiomas. O diretor de pesquisa, Dr. Donald A. DePalma, foi direto: “se uma empresa optar por não localizar a experiência de compra, corre o risco de perder 40% ou mais do mercado endereçável total”.

Uma interface de aplicativo não funciona como uma página de marketing

Uma página de destino é um bloco fixo de texto que já está no HTML quando a página é carregada. Um app é uma máquina que produz texto. Um erro de validação só existe depois que alguém envia um formulário incorreto. Uma notificação temporária aparece por quatro segundos. O conteúdo de uma janela modal não está no documento até que um clique o crie. Um estado vazio só aparece em contas sem dados, o que geralmente significa que você nunca vai vê-lo na sua própria máquina.

Isso importa porque toda abordagem precisa responder a uma pergunta: em que momento uma string se torna texto? Os arquivos de localidade respondem a isso no momento da compilação. Uma camada em tempo de execução responde sempre que o DOM muda. Qualquer abordagem que responda a isso apenas no carregamento da página vai deixar passar a maior parte do seu produto.

A gramática falha antes do layout

As contagens falham primeiro. O inglês tem duas formas de plural, e muito código pressupõe discretamente que isso é universal. O Unicode CLDR define seis categorias de plural: zero, um, dois, poucos, muitos e outros. O árabe usa as seis para números cardinais, o russo e o polonês usam quatro, e o japonês e o coreano usam uma. Não dá para corrigir uma string como {count} items acrescentando um “s” no final, e errar nisso faz a interface parecer quebrada, não apenas estrangeira.

Datas e números vêm em seguida. O mesmo total de um pedido é 1,299.50 nos EUA, 1.299,50 na Alemanha e 1 299,50 na França. Você não precisa de uma biblioteca para isso, porque Intl.NumberFormat e Intl.DateTimeFormat já vêm integrados em todos os navegadores atuais. A formatação é a única parte da i18n de aplicativos que a plataforma realmente resolveu para você.

Os rótulos traduzidos não cabem nos botões que você criou

A expansão do texto é um problema de layout que só aparece em produção. As orientações do W3C sobre o tamanho do texto em traduções reproduzem a tabela de expansão da IBM, e o formato dela é o oposto do que a maioria das pessoas espera: strings de origem com até dez caracteres podem aumentar de 200 a 300 por cento, enquanto strings com mais de setenta caracteres tendem a ficar em torno de 130 por cento.

Pense nisso no contexto de uma interface. Seus parágrafos mais longos são os elementos mais seguros da página. Os botões, os rótulos das abas e os itens do menu são os que acabam sofrendo. A mesma página do W3C mede a palavra “views” como 2,8 vezes mais longa em alemão do que em inglês. A direção é a outra metade do problema: o W3C contabiliza doze sistemas de escrita da direita para a esquerda em 215 idiomas, e RTL é um problema de CSS, não de tradução.

Opção um: uma biblioteca de i18n em tempo de compilação

Você envolve cada string visível para o usuário em uma chamada de função, extrai essas strings para arquivos JSON por localidade e as inclui no app. i18next é a opção padrão em JavaScript, com cerca de 16 milhões de downloads semanais do pacote principal no npm e outros 11,6 milhões de downloads de react-i18next (npm, semana de 5 de setembro de 2026). A documentação da própria biblioteca descreve corretamente seu escopo: “i18next vai além de apenas oferecer os recursos padrão de i18n, como plurais, contexto, interpolação e formatação”.

Esse é o verdadeiro argumento a favor dela. Você tem categorias de plural, interpolação, variantes de contexto, namespaces carregados sob demanda e, o mais importante, traduções que ficam fora do navegador, para que e-mails, PDFs e erros da API compartilhem um catálogo. O custo é o tempo de engenharia: alguém precisa envolver as strings e evitar que textos sem tradução acabem em cada pull request.

Opção dois: uma camada de tradução em tempo de execução

A outra abordagem deixa seu código intacto. Um script monitora o DOM renderizado, coleta o texto visível e o substitui à medida que os nós aparecem. Como reage às mutações, e não ao carregamento das páginas, ele detecta modais, notificações toast e linhas que chegam de uma API depois que a página já carregou.

A vantagem mais clara é a velocidade. Você tem uma interface traduzida em uma tarde, sem tocar em nenhum componente, o que funciona bem para ferramentas internas, painéis administrativos e produtos em estágio inicial. A abordagem também lida com conteúdo gerado por usuários, algo que arquivos de localização não conseguem fazer estruturalmente, porque nenhuma etapa de build sabe o que seus clientes vão escrever.

As limitações são ainda mais importantes. A abordagem não consegue traduzir uma string que nunca chega ao DOM, então e-mails transacionais, notificações push e respostas de API não são alterados. Ela adiciona uma ida e volta à rede na primeira renderização, então planeje-se para um breve flash de conteúdo sem tradução.

Onde traçar o limite entre as duas abordagens

Na prática, o limite é definido pela responsabilidade, não pela tecnologia. Se uma string faz parte da especificação do produto, com um texto revisado e aprovado, ela deve ficar nos arquivos de localização. O Project Fluent da Mozilla defende essa ideia melhor do que qualquer outro: "Os tradutores devem poder usar todo o poder expressivo de seu idioma sem pedir permissão aos desenvolvedores." Você não consegue isso com um sistema que só vê o inglês renderizado.

Todo o resto é conteúdo: textos de ajuda, changelogs, marketing no aplicativo e qualquer coisa escrita pelos próprios usuários. Essa é a parte para a qual o WeLocale foi criado, com uma tag script, tradução com IA aplicada ao DOM ativo, incluindo conteúdo carregado depois da página, e um editor para corrigir qualquer string que a máquina tenha traduzido errado. O WeLocale realmente é a ferramenta errada se as strings traduzidas fizerem parte da especificação do seu produto.

As armadilhas que aparecem na segunda semana

Defina o atributo lang e altere-o quando o idioma mudar. Os leitores de tela usam esse atributo para determinar as regras de pronúncia. O critério de sucesso 3.1.2 da WCAG 2.2 exige que "o idioma humano de cada passagem ou frase no conteúdo possa ser determinado por software", e telas de aplicativos com vários idiomas são exatamente o caso para o qual esse critério foi criado.

Ignore SEO para qualquer conteúdo atrás de um login. Os rastreadores nunca veem essas páginas, então hreflang e URLs de idioma indexáveis são trabalho desperdiçado nesse caso. Eles só importam nas suas páginas públicas.

Use o cache de forma intencional. Os pacotes de localização devem ser imutáveis e ter uma impressão digital, e as traduções em tempo de execução devem ser armazenadas em cache localmente para que usuários recorrentes não precisem buscá-las de novo. E escreva um teste que renderize sua string mais longa em alemão no seu botão mais estreito.

FAQ

Posso traduzir um aplicativo React ou Vue sem reescrever os componentes? Sim, com uma camada em tempo de execução que observa o DOM e substitui o texto depois que seu framework o renderiza. Ela cobre modais, notificações toast e dados que chegam de uma API. Não consegue cobrir strings que nunca são renderizadas no navegador, como e-mails transacionais ou mensagens de erro de API.

E quanto ao texto que os próprios usuários escrevem? Arquivos de localização não ajudam, porque nenhuma etapa de build sabe o que um usuário vai escrever. O conteúdo gerado por usuários precisa ser traduzido em tempo de execução, seja por uma camada no nível do DOM, seja chamando uma API de tradução do seu próprio código antes de exibi-lo.

Preciso de tags hreflang para o painel do aplicativo? Não. Páginas atrás de um login nunca são rastreadas, então hreflang e URLs de idioma indexáveis não servem para nada nesse caso. Adicione-os às suas páginas públicas: site de marketing, documentação, preços e a própria tela de login.

Quer isso no seu próprio site? Adicione mais de 50 idiomas com um único snippet, sem mudanças no código.

Experimente o WeLocale grátis