Sprachen und Textrichtung
Lege Sprache und Textrichtung für Dokumente und lokalisierte Teilbäume anhand der Sprachmetadaten der Laufzeitumgebung fest.
Übersetzter Text und Textrichtung des Dokuments müssen zusammenpassen. Ein arabischer Nachrichtenkatalog ändert die Texte, doch der Browser benötigt zusätzlich dir="rtl", um die Seite in der vorgesehenen Leserichtung darzustellen. Verwende die ermittelte Sprache sowohl für den Provider als auch für die Dokumentattribute.
Sprache und Textrichtung gemeinsam festlegen #
Leite die Attribute in der Dokument- oder Shell-Komponente deines Frameworks aus der Sprache ab, die für die jeweilige Anfrage ausgewählt wurde:
import type { ReactNode } from "react";
import { createLingo, LingoProvider, type Messages } from "@lingo.dev/react";
export function LocalizedDocument({ locale, messages, children }: {
locale: string;
messages: Messages;
children: ReactNode;
}) {
const l = createLingo(locale);
return (
<html lang={l.locale} dir={l.direction}>
<body>
<LingoProvider locale={locale} messages={messages}>
{children}
</LingoProvider>
</body>
</html>
);
}Behalte die vom Framework benötigten Head-, Skript- und Hydrationskomponenten rund um dieses Muster bei. Für einen lokalisierten Teilbaum innerhalb einer anderssprachigen Seite setzt du stattdessen lang und dir am umschließenden Element. Verwende dafür das useLingo()-Ergebnis dieses Teilbaums. Ein Attribut auf Abschnittsebene ersetzt nicht die Sprachangabe für das gesamte Dokument.
Setze die Attribute nach Möglichkeit bereits im initialen HTML. Wenn die Textrichtung erst nach der Hydration aktualisiert wird, kann die Seite zunächst mit dem falschen Layout erscheinen.
Metadaten genau interpretieren #
| Eigenschaft | Bedeutung |
|---|---|
locale: string | Die übergebene Sprache, unverändert. |
direction: "ltr" | "rtl" | Die native Intl.Locale.textInfo-Textrichtung, sofern verfügbar, andernfalls der sprachbasierte Ersatzwert der Laufzeitumgebung. |
script: string | undefined | Das wahrscheinliche Schriftsystem, ermittelt durch Maximierung der Sprache mit Intl.Locale. |
region: string | undefined | Die wahrscheinliche Region aus derselben Maximierung. |
Zum Beispiel kann createLingo("en") die Werte Latn und US ableiten. Dabei werden wahrscheinliche Sprach-Subtags ergänzt. Das ermittelt weder den Standort der lesenden Person noch legt es ein Rechnungsland fest. Verwende tatsächliche Konto- oder Standortdaten, wenn die Anwendung diese Angaben benötigt.
Wenn Intl.Locale nicht verfügbar oder das Tag ungültig ist, können Schriftsystem und Region undefiniert sein. Die Textrichtung wird dann anhand der ersatzweise verwendeten Sprachliste bestimmt. Andere native Formatierer können ein ungültiges Tag dennoch zurückweisen. Gleiche die Sprache vor dem Rendern mit den von der Anwendung unterstützten Sprachen ab.
Layout an der Leserichtung ausrichten #
Verwende logische CSS-Eigenschaften wie margin-inline-start und padding-inline-end für Abstände, die sich an der Textrichtung orientieren. Betrachte jedes Symbol einzeln: Ein Navigationspfeil muss möglicherweise umgedreht werden, das Bild eines physischen Objekts dagegen nicht. Die Sprachmetadaten liefern die Textrichtung; das Komponentendesign bestimmt, wie sie sich auf die Oberfläche auswirken soll.
Der Provider handelt keine Sprache aus und ruft keine Nachrichten ab. Locale-router liefert die Regeln für URLs und Spracheinstellungen. Der Next-Pages-Wrapper synchronisiert die Textrichtung, überlässt das Dokumentattribut lang aber der Anwendung; eine TanStack-Shell setzt beides anhand des Anfragekontexts.
Sieh dir nach einem Sprachwechsel sowohl die Dokumentattribute als auch den geladenen Nachrichtenkatalog an. Serverseitiges Rendern erklärt, warum dieselbe Sprache, dieselben Nachrichten und dieselben Formatierungseingaben auch für die Hydration bereitstehen müssen.