Mensagens com texto formatado
Traduza uma frase completa sem tirar do código da aplicação os destinos dos links e o comportamento do React.
Um link costuma fazer parte de uma frase. Traduzir separadamente as palavras antes, dentro e depois dele obriga a tradução a seguir a ordem das palavras do idioma de origem. l.rich permite traduzir a frase inteira e posicionar os elementos React nomeados nos lugares adequados 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 dentro de um provedor. O texto de origem e o contexto selecionam a entrada do catálogo da mesma forma que em l.text. O modelo traduzido define as palavras e a posição das tags; a função de retorno fornece o destino, os atributos, o estilo e o comportamento.
l.rich retorna um ReactNode. Seu RichOptions exige context, aceita um mapa values com valores de texto ou números e também aceita tags: Record<string, (children: ReactNode) => ReactNode>. Os nomes das tags devem corresponder exatamente, por isso <link> precisa de uma função de retorno link.
Insira um elemento sem filhos #
Uma tag de autofechamento chama sua função de renderização com null como filhos. Por exemplo, esta confirmação exibe um ícone decorativo após a 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. Tanto <icon/> quanto <icon /> são aceitos. Para elementos aninhados, use nomes distintos, como <link><strong>refund policy</strong></link>, e forneça as duas funções de retorno. O analisador usa a próxima tag de fechamento correspondente; o aninhamento de tags com o mesmo nome não é aceito como uma estrutura HTML com abertura e fechamento balanceados.
Verifique também as tags da tradução, não só as palavras #
Quando uma tag com abertura e fechamento ou uma tag de autofechamento não tem uma função de retorno, ela permanece como texto literal. Uma tag de abertura sem o fechamento correspondente também permanece como texto literal. Assim, a mensagem ainda pode ser renderizada, mas quem lê pode ver <link> em vez de um link funcional.
Teste o modelo traduzido com suas funções de retorno reais. Verifique o texto do link e href e inclua um caso com uma tag ausente para que marcações acidentais fiquem visíveis durante o desenvolvimento. Testes de renderização não exigem uma solicitação de tradução.
A marcação aceita consiste em tags nomeadas, não em HTML arbitrário. Defina os atributos na função de retorno em vez de escrevê-los na tradução. Usar dangerouslySetInnerHTML para lidar com uma tag sem correspondência eliminaria essa separação.
Use valores simples em mensagens com texto formatado #
O texto formatado substitui valores simples {name} em segmentos de texto. Ele não executa o formatador ICU complexo usado por l.text. Para construções gramaticais que dependem da quantidade, use plurais e seleções ou organize a interface em torno de mensagens gramaticalmente completas que possam ser expressas pela representação de texto formatado aceita. Um plural ICU não processado dentro de um modelo de texto formatado não passará a aplicar regras de plural só por conter chaves.