Bidi: Conteúdo Misto Persa/Inglês
O algoritmo BiDi do Unicode reordena automaticamente o texto de direção mista — às vezes, incorretamente. Este skill ensina quando intervir e exatamente como.
1. O modelo mental
- A direção base vem de
dirno ancestral mais próximo (página: RTL). - Sequências de conteúdo forte LTR (letras latinas) são incorporadas e fluem LTR internamente.
- Caracteres neutros (pontuação, sinais adjacentes a dígitos como + - / $ %) assumem a direção do ambiente ao redor — é aqui que ocorre o embaralhamento.
2. A caixa de ferramentas de intervenção
| Ferramenta | Quando | Exemplo |
|---|---|---|
Elemento <bdi> | Átomo estrangeiro inline dentro de texto persa, direção desconhecida | «فایل report_final.pdf را ببینید» |
<span dir="ltr"> | Átomo conhecido LTR que você também quer alinhado à esquerda internamente | <span dir="ltr">+98 912 345 6789</span> |
dir="auto" | Conteúdo gerado pelo usuário ou imprevisível | bolhas de chat, comentários, nomes de arquivos |
CSS unicode-bidi: plaintext | Mesmo que dir="auto", mas para spans estilizados | .user-content { unicode-bidi: plaintext; } |
isolate (padrão para bdi) | Impede que o átomo reordene vizinhos | comportamento padrão de <bdi> |
3. Casos canônicos
Números de telefone
+98 912 em texto persa frequentemente renderiza o + no lado errado.
تلفن پشتیبانی: <span dir="ltr">+98 21 9100 2000</span>
Preços em moeda estrangeira
$99 flutuando em texto RTL se torna 99$:
اشتراک جهانی: <span dir="ltr">$99/mo</span> — اشتراک داخلی: ۹۹٬۰۰۰ تومان
E-mails, URLs, handles
به <bdi>[email protected]</bdi> ایمیل بزنید.
مستندات: <bdi>https://docs.example.co/fa</bdi>
Nomes de marcas latinas no meio da frase
Geralmente funciona como texto simples, mas após um sufixo persa quebra:
«نسخهی جدید Node.js» — «Node.js» está seguro; «های Node.js» precisa de <bdi> ao redor da sequência latina se um sufixo se anexar: <bdi>Node.js</bdi>های está errado — reformule para «افزونههای Node.js».
Código e comandos — sempre blocos LTR
<pre dir="ltr" style="text-align: left;">npm install raast</pre>
Comandos inline em prosa persa: <code dir="ltr">npx create-next-app</code>.
Listas de itens mistos
Marcadores de item (۱ ۲ ۳) vivem no fluxo RTL; itens LTR longos dentro permanecem isolados por item — coloque <bdi> em qualquer item que comece com letras latinas/dígitos.
Identificadores de produto, seriais e IDs técnicos
A categoria de maior embaralhamento — letras, dígitos e traços misturados:
شماره سریال: <bdi dir="ltr">SN-9F42-KM18</bdi>
کد پیگیری: <bdi dir="ltr">TRK-IR-14050823-0042</bdi>
شناسه محصول: <bdi dir="ltr">SKU 88451-B</bdi>
Regras:
- Identificadores devem permanecer byte-exatos quando copiados — o isolamento só altera a renderização, nunca a string.
- Sequências de traço/dígito no final dentro de uma frase RTL serão reordenadas sem
<bdi>(ex.:88451-B→B-88451). - Consultas a banco de dados feitas em JS: mantenha a string lógica; não "pré-inverta" para exibição.
- Fonte monoespaçada de largura fixa +
dir="ltr"+text-align: startpara colunas de ID em tabelas.
Conteúdo gerado pelo usuário (chat, comentários, nomes de arquivos)
- Contêiner:
dir="auto"+ CSSunicode-bidi: plaintext— cada mensagem se orienta pelo seu primeiro caractere forte. - Um usuário persa colando texto em inglês, ou vice-versa, deve ler corretamente sem alternar
dirmanualmente. - Nunca imponha a direção da página ao UGC com
dir="rtl"+text-align: startsozinho; a regra do primeiro caractere forte é o objetivo deplaintext. - Nomes de arquivos/downloads: renderize em
<bdi>para que extensões (.pdf,.zip) não se desprendam.
4. Inputs de formulário
dir="auto": o input adota a direção do primeiro caractere forte — certo para campos de nome/mensagem.dir="ltr"explícito: e-mail, telefone, nome de usuário, número de cartão, URL, preço (comtext-align: endpara o cursor começar à direita para usuários RTL... na verdade, mantenhatext-align: startno input ltr para sanidade do cursor; teste).
5. Depuração de saída embaralhada — a lista de verificação
- O átomo está encapsulado/isolado? (bdi / span dir=ltr)
- Caracteres neutros (
+ - / . , ( )) estão adjacentes a um limite de direção? Adicione isolamento ou uma marca RLM (\u200F)/LRM (\u200E). - Pontuação final de um átomo LTR pulando para a extremidade errada → inclua o espaço final dentro do isolamento.
- String construída em JS? Bidi é uma preocupação de renderização — não reordene no código, corrija o DOM/CSS.
- Dump de caracteres invisíveis: cole em um inspetor bidi ou
JSON.stringify()o texto para ver a colocação de U+200E/F.
6. RLM/LRM — o bisturi
‏ (U+200F) / ‎ (U+200E) forçam caracteres neutros para um lado quando o isolamento é impossível (ex.: e-mails de texto simples, células CSV):
متن فارسی +98 -> mantém o + anexado ao número
Use com moderação — mojibake visível em algumas fontes; prefira isolamento estrutural na web.
7. Títulos, meta e contextos de linha única
<title>com scripts mistos: navegadores renderizam bidi em abas razoavelmente, mas comece com o idioma da página: «raast — مهارتهای RTL» vs «مهارتهای RTL — raast»: coloque o script forte do idioma da página primeiro.- Strings
aria-labelseguem as mesmas regras; leitores de tela lidam com marcas bidi unicode, então mantenha-as. - Payloads JSON/API: sempre armazene a ordem lógica; nunca inverta previamente nada para exibição.