Quando se trata de aplicações multilíngues, especialmente com React e react-i18next, uma dificuldade recorrente é manter a tradução de textos que incluem elementos HTML dinâmicos, como links, de forma que seja fácil para tradutores ajustarem o conteúdo, sem perder a consistência técnica no código. --- ### O problema de interpolação de links em textos multilíngues Em muitos cenários, precisamos inserir links ou outros elementos HTML em textos traduzidos. O desafio é fazer isso de modo que o conteúdo seja facilmente traduzível, sem precisar dividir o texto em várias chaves ou criar versões específicas para cada idioma, o que pode gerar confusão ou erros na tradução. A decisão fica mais saudável quando o time consegue medir o impacto depois. Sem esse critério, a solução pode parecer simples no começo e cara no suporte. Por exemplo, imagine uma mensagem que, em português, fica assim: "Para mais informações, clique aqui." Com um link no meio, a tradução deve conter o elemento HTML adequado, porém, a inserção direta no arquivo de tradução pode comprometer a qualidade da tradução, especialmente em idiomas com estruturas gramaticais diferentes. Sem esse critério, a solução pode parecer simples no começo e cara no suporte. O valor aparece melhor quando operação, produto e engenharia olham para o mesmo risco. --- ### A solução oficial do react-i18next Com a versão mais recente do react-i18next, a equipe introduziu o componente ``, que possibilita uma interpolação mais natural de elementos React dentro de textos multilíngues. Ele permite que o conteúdo seja definido na tradução usando marcadores de posição, que são substituídos por componentes React no momento da renderização. Por isso, o recorte precisa considerar manutenção, validação e caminho de volta. Por exemplo, uma tradução poderia ser: "Veja a <1>aqui para mais detalhes." E, na renderização, você usa o componente `` assim: ```jsx Veja a aqui para mais detalhes. ``` O benefício é que o tradutor pode mover o link onde desejar na frase, ajustando a tradução sem mexer no código, enquanto o componente garante que a interpolação seja feita corretamente. A decisão fica mais saudável quando o time consegue medir o impacto depois. Sem esse critério, a solução pode parecer simples no começo e cara no suporte. O valor aparece melhor quando operação, produto e engenharia olham para o mesmo risco. Por isso, o recorte precisa considerar manutenção, validação e caminho de volta. Esse contexto ajuda a separar ganho real de novidade difícil de sustentar. --- ### Como aplicar essa técnica na prática Para facilitar a manutenção de textos multilíngues, recomendo seguir uma abordagem onde a tradução contém marcadores de posição numérica ou nomeada, e o componente React fornece os elementos correspondentes. Sem esse critério, a solução pode parecer simples no começo e cara no suporte. O valor aparece melhor quando operação, produto e engenharia olham para o mesmo risco. Por isso, o recorte precisa considerar manutenção, validação e caminho de volta. Esse contexto ajuda a separar ganho real de novidade difícil de sustentar. A decisão fica mais saudável quando o time consegue medir o impacto depois. Sem esse critério, a solução pode parecer simples no começo e cara no suporte. No arquivo de tradução: ```json { "descricao": "Clique <1>aqui para continuar." } ``` O valor aparece melhor quando operação, produto e engenharia olham para o mesmo risco. Na implementação: ```jsx Veja aqui para continuar. ``` Por isso, o recorte precisa considerar manutenção, validação e caminho de volta. O valor aparece melhor quando operação, produto e engenharia olham para o mesmo risco. O valor aparece melhor quando operação, produto e engenharia olham para o mesmo risco. O valor aparece melhor quando operação, produto e engenharia olham para o mesmo risco. O valor aparece melhor quando operação, produto e engenharia olham para o mesmo risco. O valor aparece melhor quando operação, produto e engenharia olham para o mesmo risco. O valor aparece melhor quando operação, produto e engenharia olham para o mesmo risco. O valor aparece melhor quando operação, produto e engenharia olham para o mesmo risco. Ou, usando o recurso de componentes passados como props: ```jsx }}>Clique <1>aqui para continuar. ``` Esse contexto ajuda a separar ganho real de novidade difícil de sustentar. Por isso, o recorte precisa considerar manutenção, validação e caminho de volta. Por isso, o recorte precisa considerar manutenção, validação e caminho de volta. Por isso, o recorte precisa considerar manutenção, validação e caminho de volta. Por isso, o recorte precisa considerar manutenção, validação e caminho de volta. Por isso, o recorte precisa considerar manutenção, validação e caminho de volta. Esse contexto ajuda a separar ganho real de novidade difícil de sustentar. Por isso, o recorte precisa considerar manutenção, validação e caminho de volta. Por isso, o recorte precisa considerar manutenção, validação e caminho de volta. Este método garante que a tradução possa ser adaptada para diferentes idiomas, respeitando as regras gramaticais locais. A decisão fica mais saudável quando o time consegue medir o impacto depois. Esse contexto ajuda a separar ganho real de novidade difícil de sustentar. A decisão fica mais saudável quando o time consegue medir o impacto depois. Esse contexto ajuda a separar ganho real de novidade difícil de sustentar. Esse contexto ajuda a separar ganho real de novidade difícil de sustentar. Esse contexto ajuda a separar ganho real de novidade difícil de sustentar. A decisão fica mais saudável quando o time consegue medir o impacto depois. Esse contexto ajuda a separar ganho real de novidade difícil de sustentar. --- ### Considerações finais e pontos de atenção - Sempre priorize o uso do `` ao invés de manipular HTML via `dangerouslySetInnerHTML`, pois isso mantém a segurança e a integridade do conteúdo. - Mantenha as traduções simples, evitando textos muito longos com múltiplas marcas de interpolação, para facilitar a leitura e revisão por tradutores. - Teste as traduções em diferentes idiomas e contextos, principalmente em línguas com estrutura gramatical distinta do português. - Lembre-se que a consistência na gestão de elementos dinâmicos melhora a experiência do usuário e reduz o risco de erros de renderização. No seu projeto, essa abordagem melhora a manutenção e a qualidade das traduções, além de facilitar o trabalho de tradutores e equipes de conteúdo. Sem esse critério, a solução pode parecer simples no começo e cara no suporte. A decisão fica mais saudável quando o time consegue medir o impacto depois. A decisão fica mais saudável quando o time consegue medir o impacto depois. Sem esse critério, a solução pode parecer simples no começo e cara no suporte. A decisão fica mais saudável quando o time consegue medir o impacto depois. A decisão fica mais saudável quando o time consegue medir o impacto depois. A decisão fica mais saudável quando o time consegue medir o impacto depois. Seus textos multilíngues podem ganhar em flexibilidade e precisão com o uso adequado do ``, alinhando a implementação técnica às necessidades de conteúdo. Como vocês costumam lidar com esses elementos em textos multilíngues? Alguma estratégia que funcione melhor no seu time? O valor aparece melhor quando operação, produto e engenharia olham para o mesmo risco. Sem esse critério, a solução pode parecer simples no começo e cara no suporte. Sem esse critério, a solução pode parecer simples no começo e cara no suporte. Sem esse critério, a solução pode parecer simples no começo e cara no suporte. Sem esse critério, a solução pode parecer simples no começo e cara no suporte.

Tiago Ramos

Gerenciamento de links interpolados em textos multilíngues com react-i18next