Deine erste übersetzte Nachricht rendern
Zeige eine spanische Begrüßung an, setze einen Namen ein und teste mit einem lokalen Katalog den Rückgriff auf den Quelltext.
Rendere Hola, Ana. auf Basis einer englischen Quellnachricht. Dieses Beispiel bringt eine eigene spanische Übersetzung mit. So siehst du genau, wie Komponente, Katalog und Provider zusammenarbeiten. Dafür brauchst du weder ein Lingo.dev-Konto noch einen API-Schlüssel.
In einer React-19-Anwendung installieren #
npm install @lingo.dev/react@1.17.1Verwende für diese Anleitung eine bestehende React-19-Anwendung. Das Paket deklariert zwar React 18 und 19 als Peer-Abhängigkeiten, der Provider nutzt aber die Kurzschreibweise für Kontext-Provider aus React 19. Die Installation in einem React-18-Projekt belegt daher nicht, dass das Paket dort auch rendern kann.
Begrüßung und Katalog hinzufügen #
Füge diese Komponente in src/App.tsx ein und rendere sie über den bestehenden Einstiegspunkt deiner Anwendung:
import { computeKey, LingoProvider, useLingo } from "@lingo.dev/react";
const messages = {
[computeKey("Hello, {name}.", "Greeting on the account dashboard")]:
"Hola, {name}.",
};
function Greeting() {
const l = useLingo();
return (
<h1>
{l.text("Hello, {name}.", {
context: "Greeting on the account dashboard",
values: { name: "Ana" },
})}
</h1>
);
}
export default function App() {
return (
<LingoProvider locale="es" messages={messages}>
<Greeting />
</LingoProvider>
);
}Führe den Entwicklungsbefehl deiner Anwendung aus und öffne die Seite. Die Überschrift lautet Hola, Ana. Die Laufzeitumgebung berechnet aus Quelltext und Kontext denselben Schlüssel, findet die spanische Vorlage und ersetzt {name} durch Ana.
Der Katalog enthält den ganzen Satz, damit die Übersetzung die Wortstellung ändern kann. Der Name ist ein Wert, kein Teil des Schlüssels. Auch bei einem anderen Namen wird derselbe Katalogeintrag verwendet. Behalte Quelltext und Kontext als Literale im Aufruf von l.text bei, damit das Extraktionswerkzeug sie später erkennen kann.
Testen, was ohne Übersetzung passiert #
Übergib dem Provider vorübergehend messages={{}}. Die Überschrift lautet jetzt Hello, Ana. Der Quelltext dient als Ersatzvorlage, und die Werte werden weiterhin eingesetzt. Auch bei einem Eintrag mit dem Wert "" wird der Quelltext verwendet.
Stelle messages wieder her und ändere dann nur den Kontext des Aufrufs auf "Greeting on the profile page". Dadurch erhält die Nachricht eine andere Identität, und die ursprüngliche Übersetzung passt nicht mehr. Stelle den ursprünglichen Kontext wieder her, um erneut Hola, Ana. anzuzeigen. Mit diesen Tests kannst du unterscheiden, ob der Katalog fehlt oder die angeforderte Nachricht nicht mit der übersetzten Nachricht übereinstimmt.
Die lokale Zuordnung durch extrahierte Kataloge ersetzen #
Die Komponente ist bereit für die Extraktion. Unter Kataloge extrahieren und laden erfährst du, wie du locales/en.jsonc generierst, in der CLI-Konfiguration auswählst, eine spanische Zielübersetzung abrufst und sie sicher lädst. Das ist die nächste Aufgabe, die du vollständig umsetzt. Das lokale Beispiel oben bleibt als Rendering-Test nützlich.
Für eine Anwendung mit Routing geht es mit Next.js Pages oder TanStack Start weiter. Bei einem Sprachwechsel müssen die neue Sprache und ihre Nachrichten gemeinsam bereitstehen, damit die Benutzeroberfläche nie den Text einer Sprache mit der Formatierung einer anderen kombiniert.