Mensagens com texto formatado
Traduza uma frase completa, mantendo os destinos das ligações e o comportamento do React no código da aplicação.
Uma ligação faz muitas vezes parte de uma frase. Traduzir separadamente as palavras antes, dentro e depois da ligação obriga a tradução a manter a ordem das palavras da língua de origem. l.rich permite traduzir a frase como um todo e colocar os elementos React com nome nas posições adequadas no modelo traduzido.
Mantenha a frase completa #
import { useLingo } from "@lingo.dev/react";
export function PurchaseNotice({ product }: { product: string }) {
const l = useLingo();
return (
<p>
{l.rich("Read the <link>refund policy</link> before buying {product}.", {
context: "Purchase notice linking to the refund policy",
values: { product },
tags: {
link: (children) => <a href="/refund-policy">{children}</a>,
},
})}
</p>
);
}Renderize este componente sob um fornecedor na hierarquia de componentes. O texto de origem e o contexto selecionam a entrada do catálogo, tal como acontece com l.text. O modelo traduzido controla as palavras e a posição das etiquetas; a função de retorno fornece o destino, os atributos, os estilos e o comportamento.
l.rich devolve um ReactNode. O seu RichOptions requer context, aceita um mapa values com valores de texto ou numéricos e aceita tags: Record<string, (children: ReactNode) => ReactNode>. Os nomes das etiquetas têm de corresponder exatamente, pelo que <link> precisa de uma função de retorno link.
Insira um elemento sem filhos #
Uma etiqueta de fecho automático chama a respetiva função de renderização com null como filhos. Por exemplo, esta confirmação coloca um ícone decorativo a seguir à mensagem:
const confirmation = l.rich("Saved <icon/>", {
context: "Confirmation that account settings were saved",
tags: {
icon: () => <span aria-hidden="true">✓</span>,
},
});Aqui, l é o resultado useLingo() do componente. São suportados tanto <icon/> como <icon />. Para elementos aninhados, utilize nomes distintos, como <link><strong>refund policy</strong></link>, e forneça ambas as funções de retorno. O analisador utiliza a próxima etiqueta de fecho correspondente; o aninhamento de etiquetas com o mesmo nome não é suportado como estrutura HTML com abertura e fecho equilibrados.
Verifique as etiquetas traduzidas, não apenas as palavras #
Quando uma etiqueta com abertura e fecho ou uma etiqueta de fecho automático não tem uma função de retorno, mantém-se como texto literal. Uma etiqueta de abertura sem fecho correspondente também se mantém como texto literal. Assim, a mensagem continua a poder ser renderizada, mas o leitor pode ver <link> em vez de uma ligação utilizável.
Teste o modelo traduzido com as funções de retorno reais. Verifique o texto da ligação e href e inclua um caso com uma etiqueta em falta, para que qualquer marcação acidental fique visível durante o desenvolvimento. Os testes de renderização não exigem qualquer pedido de tradução.
A marcação suportada consiste em etiquetas com nome, não em HTML arbitrário. Defina os atributos na função de retorno em vez de os escrever na tradução. Utilizar dangerouslySetInnerHTML para tratar uma etiqueta sem correspondência eliminaria essa separação.
Utilize valores simples em mensagens com texto formatado #
O texto formatado substitui valores {name} simples em segmentos de texto. Não executa o formatador ICU complexo utilizado por l.text. Para construções gramaticais que dependem da quantidade, utilize plurais e seleções ou organize a interface em torno de mensagens gramaticalmente completas que a representação de texto formatado suportada consiga expressar. Uma expressão de plural ICU em bruto num modelo de texto formatado não passa a funcionar como plural só por conter chavetas.