React-Nachrichten
Halte Ausgangstext und Kontext direkt in deinen Komponenten und rendere übersetzte Kataloge mit Werten, Grammatik und React-Elementen.
Die Nachricht einer Komponente gehört zu der Aktion, die sie erklärt. „Speichern“ in einem Formular übermittelt Änderungen; „Speichern“ bei einem Artikel setzt ein Lesezeichen. Wenn Ausgangstext und Bedeutung zusammenbleiben, wird dieser Unterschied beim Übersetzen deutlich. Auch bei der Entwicklung lässt sich die Komponente so verstehen, ohne einen Schlüssel in einer anderen Datei nachschlagen zu müssen.
@lingo.dev/react verwendet explizite Nachrichtenaufrufe:
import { useLingo } from "@lingo.dev/react";
export function SaveButton() {
const l = useLingo();
return <button type="submit">{l.text("Save", { context: "Submit changes to account settings" })}</button>;
}Ausgangstext und Kontext identifizieren eine Nachricht in einem Katalog, der Schlüssel übersetzten Zeichenfolgen zuordnet. Ein Provider stellt diesen Katalog und die aktive Sprache bereit. Die Komponente erhält den übersetzten Text oder, wenn der Eintrag fehlt oder leer ist, den Ausgangstext.
Von der Komponente in eine andere Sprache #
Rendere zunächst eine lokale Übersetzung. Ein kleiner Katalog macht die Zuordnung nachvollziehbar – ganz ohne Konto oder Netzwerkanfrage.
Für den Workflow deiner Anwendung sammelt lingo extract erkennbare Aufrufe in einem JSONC-Quellkatalog und generiert TypeScript-Deklarationen. Die CLI sendet diese Datei zur Übersetzung und ruft die Zieldatei ab. Dein Loader wandelt die Datei in die Zuordnung von Schlüsseln zu Zeichenfolgen um, die der Provider verwendet. Kataloge extrahieren und laden führt dich durch den gesamten Prozess und zeigt auch, wie aktive Nachrichten erhalten bleiben, wenn im übersetzten JSONC die Metadatenkommentare verloren gegangen sind.
Das Rendering erfolgt lokal. Die Laufzeitumgebung kontaktiert keine Lokalisierungs-Engine und enthält keinen API-Schlüssel. Belasse die serverseitige Übersetzung in der API-Integration und stelle die resultierenden Kataloge über den üblichen Build-Prozess oder das Laden bei Anfragen in deiner Anwendung bereit.
Schreibe die Nachricht, die dein Publikum braucht #
Verwende einen vollständigen Satz mit Platzhaltern, statt einzeln übersetzte Textfragmente aneinanderzureihen. In einer anderen Sprache stehen Name, Anzahl oder Link möglicherweise an einer anderen Stelle im Satz.
| Was die Nachricht braucht | Verwende |
|---|---|
| Einfacher Text mit Werten | l.text. |
| Links, Hervorhebungen oder ein anderes React-Element | l.rich mit benannten Render-Callbacks. |
| Mengenabhängige Grammatik oder eine Auswahl nach Kategorien | l.plural und l.select. |
| Zahlen, Datumsangaben, Listen oder sprachabhängige Textoperationen | Formatierungsmethoden, die natives Intl verwenden. |
Die Referenz zu Provider und Hooks erklärt verschachtelte Kataloge und createLingo für Code außerhalb von Komponenten. Sprachmetadaten liefern Informationen zu Schreibrichtung, Schriftsystem und Region, damit du Dokument und Layout gezielt gestalten kannst.
Verbinde die Anwendung rund um deine Nachrichten #
Die Adapter für Next.js Pages und TanStack Start verbinden Kataloge mit den jeweiligen Routing-Systemen. Lade bei einem anderen Setup die Sprache und die Nachrichten vor dem Rendering und behalte diese Kombination beim serverseitigen Rendering und bei der Hydration bei.
Nutze generierte Typen, um Fehler in Ausgangstext, Kontext und Werten schon beim Bearbeiten zu erkennen. Mit Rendering-Tests testest du die tatsächlich geladenen Vorlagen. Wenn eine Übersetzung nicht erscheint, hilft dir die Fehlerbehebung, die Zuordnung von der Komponente bis zum Katalog nachzuvollziehen.
Exporte #
Der Haupteinstiegspunkt exportiert LingoProvider, useLingo, createLingo und computeKey sowie die Typen LingoProviderProps, Lingo, Messages, LingoMessages, MessageKey, TextOptions, RichOptions, PluralForms, SelectForms und FormatMethods. Der separate Einstiegspunkt @lingo.dev/react/testing exportiert withLingo und renderStatic.