Messages en texte enrichi
Traduisez une phrase complète tout en gardant les destinations des liens et le comportement React dans le code de l’application.
Un lien s’intègre souvent dans une phrase. Traduire séparément les mots qui le précèdent, ceux qu’il contient et ceux qui le suivent impose de conserver l’ordre des mots de la langue source. l.rich permet de traduire la phrase dans son ensemble et de laisser le modèle traduit placer les éléments React nommés au bon endroit.
Gardez la phrase d’un seul tenant #
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>
);
}Effectuez le rendu de ce composant sous un fournisseur. La source et le contexte sélectionnent l’entrée du catalogue, comme pour l.text. Le modèle traduit détermine les mots et l’emplacement des balises ; la fonction de rappel fournit la destination, les attributs, le style et le comportement.
l.rich renvoie un ReactNode. Son RichOptions nécessite context et accepte une table values de chaînes ou de nombres, ainsi que tags: Record<string, (children: ReactNode) => ReactNode>. Les noms des balises doivent correspondre exactement : <link> nécessite donc une fonction de rappel link.
Insérez un élément sans enfants #
Une balise autofermante appelle sa fonction de rendu avec null comme enfants. Par exemple, ce message de confirmation place une icône décorative après le message :
const confirmation = l.rich("Saved <icon/>", {
context: "Confirmation that account settings were saved",
tags: {
icon: () => <span aria-hidden="true">✓</span>,
},
});Ici, l est le résultat useLingo() du composant. <icon/> et <icon /> sont tous deux pris en charge. Pour les éléments imbriqués, utilisez des noms distincts, comme <link><strong>refund policy</strong></link>, et fournissez les deux fonctions de rappel. L’analyseur utilise la prochaine balise fermante correspondante ; l’imbrication répétée de balises de même nom n’est pas prise en charge comme une structure HTML aux balises correctement appariées.
Vérifiez les balises traduites autant que les mots #
Lorsqu’une paire de balises ou une balise autofermante n’a pas de fonction de rappel, elle reste du texte littéral. Une balise ouvrante sans balise fermante correspondante reste elle aussi du texte littéral. Le message peut ainsi toujours être rendu, mais la personne qui le lit peut voir <link> au lieu d’un lien utilisable.
Testez le modèle traduit avec ses fonctions de rappel réelles. Vérifiez le texte du lien et href, et incluez un cas où une balise manque pour rendre visible tout balisage accidentel pendant le développement. Les tests de rendu ne nécessitent aucune requête de traduction.
Le balisage pris en charge repose sur des balises nommées, et non sur du HTML arbitraire. Placez les attributs dans la fonction de rappel plutôt que dans la traduction. Utiliser dangerouslySetInnerHTML pour traiter une balise sans correspondance ferait disparaître cette séparation.
Utilisez des valeurs simples dans les messages enrichis #
Le texte enrichi remplace les valeurs {name} simples dans les segments de texte. Il n’exécute pas le formateur ICU complexe utilisé par l.text. Pour les règles grammaticales qui dépendent de la quantité, utilisez les pluriels et sélections, ou organisez l’interface autour de messages grammaticalement complets que la représentation enrichie prise en charge permet d’exprimer. Une expression de pluriel ICU brute dans un modèle enrichi ne gérera pas le pluriel simplement parce qu’elle contient des accolades.