JavaScript und React

Übersetze Inhalte auf einem Server, rendere Nachrichtenkataloge in React und integriere sprachabhängiges Routing in deine Anwendung.

JavaScript-Anwendungen nutzen Übersetzungen an zwei Stellen: Ein Server sendet Inhalte an eine Lokalisierungs-Engine und speichert das Ergebnis. Die Benutzeroberfläche lädt übersetzte Nachrichten und rendert sie mit den passenden Werten, der richtigen Grammatik und Formatierung. Wähle das passende Paket für den Teil, den du entwickelst.

Inhalte von deinem Server aus übersetzen #

Nutze die JavaScript-API-Anleitung, um mit nativem fetch Übersetzungsaufträge zu erstellen, ihren Fortschritt zu verfolgen und fertige Dateien herunterzuladen. Behalte den API-Schlüssel auf dem Server und speichere die Kennung jedes Auftrags zusammen mit der Quellrevision, die er übersetzt.

Für Anwendungen, die LingoDotDevEngine verwenden, gibt es eine separate SDK-v0-Referenz. Die Sync API und die clientseitige Stapelverarbeitung sind weiterhin dort dokumentiert.

Nachrichten in React rendern #

Mit React bleiben die Quellnachricht und ihr Kontext in der Komponente. Ein Katalog liefert die übersetzte Vorlage. Die Laufzeit setzt die Werte ein und erstellt die React-Elemente, die deine Anwendung steuert. Zum Rendern brauchst du keinen Übersetzungs-API-Schlüssel.

Starte mit einer übersetzten Komponente und einem lokalen Katalog. Wenn deine Anwendung wächst, kannst du Kataloge extrahieren und laden. Die Anleitungen für Next.js Pages und TanStack Start zeigen, wie du diese Kataloge mit Anfragen, Routen und der Sprachumschaltung verbindest. Für deinen eigenen Router liefert locale-router die zugrunde liegende Entscheidungslogik für URLs und Sprachpräferenzen.

Eine Payload-Anwendung verbinden #

Das Payload-CMS-Plugin stellt das Feldschema bereit und benachrichtigt Lingo.dev, wenn sich Quellinhalte ändern. Über die Payload-Integration legst du fest, welche Inhalte übersetzt und wohin sie zurückgeschrieben werden.

Beispielprojekte #

Diese Repositorys zeigen, wie Quelldateien und das Laden der Inhalte in der Anwendung zusammenspielen. Sieh dir vor dem Anpassen die Versionen der Abhängigkeiten und die Konfiguration jedes Projekts an: Einige verwenden eine andere Paketgeneration als die in diesen Anleitungen beschriebene. Verbinde in einem Fork dein eigenes Lingo.dev-Projekt, bevor du Übersetzungsaufträge einreichst.

ProjektHilfreicher Einstieg
React + ViteNachrichten in Komponenten, Extraktion und Laden von Katalogen.
Next.js PagesNachrichten auf Seiten und sprachabhängige Routen.
TypeScript-ModuleStatisch exportierte Sprachdaten. Verwende die vom TypeScript-Handler unterstützte Struktur für den Standardexport. Nicht unterstützte Exporte können dazu führen, dass keine Übersetzungseinheiten entstehen.
iOSApple-Ressourcen und native Sprachauswahl.
AndroidRessourcenverzeichnisse und Abruf von Zeichenfolgen.
FlutterARB-Metadaten und generierte Nachrichten.
MarkdownDokumentpfade und Frontmatter.
Markdoc + Next.jsÜbersetzbare Tag-Eigenschaften und Rendern von Dokumenten.
OpenAPIMenschenlesbare Beschreibungen innerhalb einer API-Spezifikation.
RailsYAML mit der Sprache als Wurzelschlüssel und Abruf über das Framework.
LaravelRessourcendateien und Laden über das Framework.

Native Ressourcen und Dokumente nutzen die CLI und die jeweiligen Format-Handler. Nur weil sie in dieser Beispielsammlung vorkommen, brauchen sie keine React-Laufzeit.