Publicamos a versão em árabe numa quinta. Os textos estavam certos, o alinhamento estava certo, e a seta de voltar continuava apontando pra saída. A barra de progresso enchia pelo lado errado, o onboarding andava pra trás e os dígitos de um telefone no meio da frase apareciam reordenados como erro de digitação. A tradução não tinha defeito nenhum. A gente só tinha colocado direction: rtl na raiz e presumido que a interface viria junto.
Não vem. Direcionalidade não é propriedade do texto, é espacial. Cada ícone que significa movimento, cada deslocamento que você escreveu com left, cada gesto e cada linha do tempo foram desenhados pensando num mundo da esquerda pra direita. Vira o texto e essas decisões ficam exatamente onde estavam, erradas em silêncio.
Onde o giro não alcança
A auditoria útil não é «a página parece espelhada?», é «que elementos carregam sentido pela direção?». Tem mais do que ninguém espera na primeira passada.
| Elemento | O que o LTR assume | O que o RTL precisa de fato | O que costuma faltar |
|---|---|---|---|
| Seta de voltar | Aponta pra esquerda | Aponta pra direita, e a pilha de navegação toda lê da direita pra esquerda | O ícone virou, o gesto de deslizar pra voltar não |
| Barra de progresso | Enche da esquerda pra direita | Enche da direita pra esquerda | width e a direção do gradiente seguem fixos |
| Telefone no meio da frase | A string tem uma direção só | Dígitos ficam LTR, o texto em volta fica RTL | Envolver a string inteira em direction: rtl |
| Rótulos de formulário | Ficam à esquerda | Ficam à direita, mas campos de número e e-mail seguem LTR | Usar text-align em vez de alinhamento lógico |
| Selos no canto | left: 8px | inset-inline-start: 8px | Pseudoelementos ainda presos ao left |
| Deslizar pra avançar | Deslizar pra esquerda avança | Avançar é da direita pra esquerda | Carrossel e onboarding mantêm a ordem LTR |
| Gráficos e linhas do tempo | O tempo vai da esquerda pra direita | O tempo vai da direita pra esquerda; rótulos do eixo são bidi | Só o contêiner virou |
Texto bidirecional é a linha que continua nos mordendo. Um número, uma marca em alfabeto latino ou um @handle dentro de uma frase árabe mantém a própria direção, e o algoritmo bidi do navegador acerta quase sempre — até você acrescentar pontuação, parênteses ou um direction a mais num contêiner. Aí o parêntese de fechamento cai do lado errado e alguém abre como bug de tradução. Não é. É bug de marcação, e nenhum tradutor consegue consertar pra você.
O custo, sem disfarce
Vamos ser diretos sobre o preço: isso é refazer o design system, não um patch na folha de estilo. Se seus componentes codificam posição com left, right, margin-left e padding-right, você tem centenas de decisões pequenas pra converter em propriedades lógicas. Já fizemos pela metade uma vez, e pela metade é pior que não começar: agora uns componentes espelham e outros não, e ninguém prevê quais. Ou você assume inline-start / inline-end na biblioteca inteira, ou aceita que RTL vai ser um build de segunda classe pra sempre.
Conteúdo de direção mista não se resolve com automação. Não existe linter que diga com confiança se uma string vai renderizar bem quando um usuário digitar o nome latino dele num campo árabe. Você precisa de fixtures reais: texto árabe real, hebraico real, um telefone de verdade, uma marca latina, uma data, revisados por alguém que lê o idioma. E isso puxa a conta que ninguém bota no sprint: a matriz de testes dobra. Cada tela, cada estado e cada animação agora tem duas direções, e a metade RTL é justamente a que o time domina menos. Já pegamos mais regressão RTL em dez minutos de passeio com um leitor nativo do que num mês comparando screenshots.
E tem o hábito desconfortável do setor que vale nomear: árabe e hebraico são tratados como polimento da semana de lançamento. O time constrói o produto inteiro em LTR, «adiciona RTL» logo antes de entrar num mercado, esbarra nos problemas de ícone e gesto acima e publica uma versão que tecnicamente funciona e soa sutilmente estranha pra quem era o público. Isso não é história de dívida técnica, é de priorização. Fazer tarde custa mais, sim; não fazer nunca custa o mercado. A gente prefere abrir a migração pra propriedades lógicas cedo, enquanto a biblioteca ainda é pequena e a discussão sai barato.
Mais um limite honesto: tem coisa que não devia espelhar. Botão de play, o sentido da barra de um player e o logo da marca costumam ficar parados, e um teclado de telefone tem lógica própria. Espelhar tudo no atacado é tão errado quanto não espelhar nada. Decidir caso a caso é mais lento, e é o trabalho.
Construa a direção dentro, não por cima
Ponha dir na raiz do documento e deixe as propriedades lógicas carregarem o layout, pra um único atributo virar a árvore inteira. Audite os ícones direcionais como um conjunto com nome, não como SVGs espalhados, e dê a eles uma variante espelhada. Mantenha explicitamente LTR os campos numéricos e latinos dentro de um formulário RTL. Acrescente fixtures bidi com pontuação real nos testes de snapshot e consiga um leitor nativo pra percorrer checkout e onboarding nas duas direções antes de chamar de pronto.
O teste rápido é de uma simplicidade irritante: mude um aparelho de teste pra árabe, abra o app, tente voltar, deslize o onboarding e leia um preço com um telefone embaixo. Se qualquer uma dessas três der sensação de estar nadando contra a corrente, o texto nunca foi o problema. Era o espaço em volta dele.
Fontes
- W3C — Internacionalização — o material de referência sobre texto bidi e o atributo
dir. - MDN — CSS direction — o que a propriedade muda e o que ela deixa de fora de propósito.
- MDN — Atributo HTML dir — definir a direção base no nível do documento.
- Apple — Diretrizes de interface humana — orientação da plataforma sobre layout RTL e quais controles não devem espelhar.
- Android Developers — suporte a RTL, alinhamento lógico e texto bidirecional no sistema anfitrião.