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.
| Projekt | Hilfreicher Einstieg |
|---|---|
| React + Vite | Nachrichten in Komponenten, Extraktion und Laden von Katalogen. |
| Next.js Pages | Nachrichten auf Seiten und sprachabhängige Routen. |
| TypeScript-Module | Statisch 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. |
| iOS | Apple-Ressourcen und native Sprachauswahl. |
| Android | Ressourcenverzeichnisse und Abruf von Zeichenfolgen. |
| Flutter | ARB-Metadaten und generierte Nachrichten. |
| Markdown | Dokumentpfade und Frontmatter. |
| Markdoc + Next.js | Übersetzbare Tag-Eigenschaften und Rendern von Dokumenten. |
| OpenAPI | Menschenlesbare Beschreibungen innerhalb einer API-Spezifikation. |
| Rails | YAML mit der Sprache als Wurzelschlüssel und Abruf über das Framework. |
| Laravel | Ressourcendateien 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.