Rich-Text-Nachrichten
Übersetze vollständige Sätze, während Linkziele und React-Verhalten im Anwendungscode bleiben.
Ein Link steht oft mitten in einem Satz. Werden die Wörter vor, in und nach dem Link getrennt übersetzt, muss die Übersetzung die Wortstellung der Ausgangssprache beibehalten. Mit l.rich bleibt der ganze Satz übersetzbar, und die übersetzte Vorlage kann benannte React-Elemente dort platzieren, wo sie hingehören.
Lass den Satz als Ganzes stehen #
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>
);
}Rendere diese Komponente unterhalb eines Providers. Ausgangstext und Kontext bestimmen den Katalogeintrag genauso wie bei l.text. Die übersetzte Vorlage legt den Wortlaut und die Position der Tags fest; der Callback liefert das Linkziel, die Attribute, das Styling und das Verhalten.
l.rich gibt ein ReactNode zurück. Sein RichOptions erfordert context und akzeptiert eine values-Map mit Zeichenfolgen oder Zahlen sowie tags: Record<string, (children: ReactNode) => ReactNode>. Tag-Namen müssen exakt übereinstimmen: <link> benötigt daher einen link-Callback.
Füge ein Element ohne Kindelemente ein #
Ein selbstschließendes Tag ruft seinen Renderer mit null als Kindelementen auf. Diese Bestätigung zeigt zum Beispiel ein dekoratives Symbol nach der Nachricht:
const confirmation = l.rich("Saved <icon/>", {
context: "Confirmation that account settings were saved",
tags: {
icon: () => <span aria-hidden="true">✓</span>,
},
});Hier ist l das useLingo()-Ergebnis der Komponente. Sowohl <icon/> als auch <icon /> werden unterstützt. Verwende für verschachtelte Elemente unterschiedliche Namen, etwa <link><strong>refund policy</strong></link>, und stelle beide Callbacks bereit. Der Parser verwendet das nächste passende schließende Tag. Verschachtelte Tags mit demselben Namen werden nicht als korrekt geschachtelte HTML-Struktur unterstützt.
Kontrolliere neben den Wörtern auch die übersetzten Tags #
Fehlt der Callback für ein Tag-Paar oder ein selbstschließendes Tag, bleibt es als unveränderter Text erhalten. Das gilt auch für ein öffnendes Tag ohne passendes schließendes Tag. Die Nachricht lässt sich so weiterhin rendern, beim Lesen ist aber möglicherweise <link> statt eines nutzbaren Links zu sehen.
Teste die übersetzte Vorlage mit ihren tatsächlichen Callbacks. Sichere den Linktext und href mit Assertions ab und ergänze einen Testfall mit fehlendem Tag, damit versehentlich eingefügtes Markup während der Entwicklung sichtbar wird. Rendering-Tests erfordern keine Übersetzungsanfrage.
Das unterstützte Markup besteht aus benannten Tags, nicht aus beliebigem HTML. Hinterlege Attribute im Callback, statt sie in die Übersetzung zu schreiben. Wenn du dangerouslySetInnerHTML zur Behandlung eines Tags ohne Gegenstück verwendest, geht diese Trennung verloren.
Verwende einfache Werte in Rich-Text-Nachrichten #
Rich Text ersetzt einfache {name}-Werte in Textsegmenten. Der komplexe ICU-Formatierer, den l.text verwendet, kommt dabei nicht zum Einsatz. Verwende für mengenabhängige Grammatik Pluralformen und Auswahlvarianten oder gestalte die Oberfläche mit vollständigen, grammatisch korrekten Nachrichten, die sich mit der unterstützten Rich-Text-Darstellung ausdrücken lassen. Ein unverarbeiteter ICU-Pluralausdruck in einer Rich-Text-Vorlage erhält nicht allein dadurch eine Pluralfunktion, dass er geschweifte Klammern enthält.