Geschrieben von Huifer
Ich betreue TanStack Ship, dessen öffentliche Website auf Englisch, Chinesisch und Deutsch läuft. Ich habe keine arabische Produktionsoberfläche ausgeliefert, deshalb stelle ich das nicht als Kunden-Fallstudie dar. Die Suchphrase „react right to left“ ist meist eine Anfrage nach der Layoutrichtung, nicht nach einer Übersetzungsbibliothek. Mit den unten genannten Standards für HTML, CSS, React, Tailwind und Browser-Tests definiere ich eine Implementierungsgrenze, die Sie prüfen können, bevor Sie einen Starter kaufen.
Verifizierte Quellen: TanStack · TanStack Router docs · HTML-Attribut
dir· CSS logical properties · Tailwind state variants · Playwright visual comparisons · web.dev · Cloudflare Workers docsZuletzt aktualisiert: 2026-11-20 · Changelog
React right-to-left support: Ein praktischer Leitfaden für 2026
React right-to-left support bedeutet, die Dokumentrichtung für die aktive Locale auf rtl zu setzen und das Layout mit richtungsbewusstem CSS auszudrücken, damit die Oberfläche korrekt gespiegelt wird, statt auseinanderzufallen. Die Textübersetzung ist eine separate Aufgabe. Dieser Leitfaden richtet sich an React-Entwickler und technische Gründer, die entscheiden müssen, ob sie RTL selbst implementieren oder einen SaaS-Starter wählen, dessen Internationalisierungs-Grundlage RTL bereits enthält.
Die Suchanfrage, die diesen Artikel ausgelöst hat, steht im gelieferten Google Search Console-Themen-Datensatz mit 18 Impressionen, 0 Klicks und einer durchschnittlichen Position von 13,8. Das ist ein gemessenes Sichtbarkeitssignal, aber nur ein Proxy für die Absicht: Null Klicks können am Snippet, an der Ergebnismischung oder an der bestehenden Abdeckung der Seite liegen. Die sichere Lesart ist, dass Suchende eine direkte Implementierungsantwort wollen, keinen weiteren Marktpotenzial-Essay.
TL;DR
- Zuerst die Richtung: Setzen Sie
dirundlangam Dokument-Root, vor dem ersten Paint.- Dann das Layout: Verwenden Sie CSS logical properties für Abstände, Rahmen, Insets und Textausrichtung.
- Dann die Ausnahmen: Verwenden Sie Tailwind-
rtl:-Varianten oder gezieltes CSS nur für richtungsabhängige Icons und Layouts, die sich nicht logisch ausdrücken lassen.- Tests: Prüfen Sie sowohl die DOM-Richtung als auch einen visuellen Snapshot in einer echten RTL-Locale.
- Käufer-Check: Ein Sprachumschalter in einem Template ist kein Beweis für RTL-Support; fragen Sie nach der Richtungsgrenze, dem Locale-Routing und den Tests.
Definition: React right-to-left support ist die Kombination aus einer expliziten Dokumentrichtung mit
dir="rtl"und bidirektionalem CSS, das Lesereihenfolge, Steuerelemente, Abstände und Navigation für Locales wie Arabisch, Hebräisch, Persisch und Urdu korrekt hält.
Was React right-to-left support tatsächlich verändert
Richtung ist nicht Übersetzung
Übersetzung verändert Wörter. Richtung verändert das Koordinatensystem, in dem diese Wörter angeordnet werden. Eine vollständig übersetzte arabische Seite kann trotzdem kaputt aussehen, wenn die Seitenleiste links bleibt, Formularlabels links ausgerichtet sind und ein Chevron in die falsche Richtung zeigt. Umgekehrt kann ein unübersetzter Prototype die korrekte Richtung demonstrieren und Layout-Bugs früh sichtbar machen.
Das HTML-Attribut dir legt die Basisrichtung für Text und Layout fest. MDN dokumentiert die Werte und Vererbungsregeln in der Referenz zum globalen Attribut dir. Das Attribut lang ist separat, aber verwandt: Es sagt assistiver Technologie und Textverarbeitung, welche Sprache vorliegt. Setzen Sie beide. Faken Sie die Richtung nicht nur mit einer CSS-Klasse.
Benennen Sie die Locales, die Sie unterstützen
Ein Direction-Helper kann mit den häufigen RTL-Sprachen beginnen, sollte sich aber nicht als vollständige Sprachdatenbank ausgeben. Arabisch, Hebräisch, Persisch und Urdu sind das übliche erste Set; weitere Sprachen und regionale Varianten brauchen eine explizite Produktentscheidung. Wenn Ihr Übersetzungssystem bereits eine Richtung pro Locale bereitstellt, verwenden Sie diese Metadaten, statt dieselbe Liste an mehreren Stellen zu duplizieren.
// direction.ts
export type Direction = "ltr" | "rtl";
const RTL_LANGUAGES = new Set(["ar", "he", "fa", "ur"]);
export function directionFor(locale: string): Direction {
const language = locale.split("-")[0].toLowerCase();
return RTL_LANGUAGES.has(language) ? "rtl" : "ltr";
}
Dieser Helper ist bewusst klein. Er lässt sich leicht testen, leicht durch Ihr Locale-Manifest ersetzen und hängt nicht von einer Browser-API ab, die in Ihrer Ziel-Runtime möglicherweise nicht verfügbar ist.
Setzen Sie die Root-Attribute an der Server-Grenze
Wenn React auf dem Server rendert, muss das initiale HTML bereits die richtige Richtung enthalten. document.documentElement.dir in einem Effect zu setzen vermeidet einen clientseitigen Crash, passiert aber nach dem ersten Paint und kann ein sichtbares Umspringen erzeugen. Rendern Sie die Root-Attribute stattdessen mit der Locale.
// Illustratives Root-Rendering. Verwenden Sie die Locale, die Ihr Router aufgelöst hat.
import { directionFor } from "./direction";
export function DocumentShell({ locale }: { locale: string }) {
return (
<html lang={locale} dir={directionFor(locale)}>
<body>{/* application */}</body>
</html>
);
}
Wenn ein Framework-Adapter den Application-Shell besitzt, prüfen Sie, dass der Adapter beide Attribute ausgibt, statt das anzunehmen. Das Dokument-Head- und Rendering-Modell von TanStack Router ist der Ort für locale-bewussten Route-Kontext; die exakte API hängt von Ihrer Version ab, prüfen Sie also die aktuelle Dokumentation. Für einen visuellen Durchgang durch das zugrunde liegende Browserverhalten erklärt die HTML-Richtlinien-Hilfe des W3C, warum das Root-Attribut wichtig ist.
Verwenden Sie logisches CSS, bevor Sie RTL-Overrides hinzufügen
Ersetzen Sie physische Properties durch logische Äquivalente
Die meisten RTL-Probleme beginnen mit Annahmen über left und right. Ein Margin, der immer links sitzt, ist auf Englisch korrekt und auf Arabisch falsch. Logical properties benennen die Kante nach Schreibrichtung statt nach Bildschirmposition, deshalb passt sich dieselbe Regel an, wenn die Richtung wechselt.
/* Physische Properties brechen, wenn sich die Richtung ändert */
.card {
margin-left: 1rem;
padding-right: 0.75rem;
border-left: 1px solid #d1d5db;
text-align: left;
}
/* Logical properties folgen der Schreibrichtung */
.card {
margin-inline-start: 1rem;
padding-inline-end: 0.75rem;
border-inline-start: 1px solid #d1d5db;
text-align: start;
}
Das Mapping ist mechanisch, sobald Sie es verinnerlicht haben. Der Guide zu CSS logical properties ist die Referenz, die Sie während des Refactorings offenhalten sollten.
| Physisches Muster | Logischer Ersatz | Typischer RTL-Fehler |
|---|---|---|
margin-left | margin-inline-start | Der Kartenabstand bleibt auf der falschen Seite |
padding-right | padding-inline-end | Der Text berührt die gespiegelte Kante |
border-left | border-inline-start | Der Akzentrahmen trennt die falsche Kante |
left: 0 | inset-inline-start: 0 | Der Drawer öffnet sich von der falschen Seite |
text-align: left | text-align: start | Labels und Überschriften wirken verloren |
right: 1rem | inset-inline-end: 1rem | Der Floating-Action-Button überlappt Inhalte |
Verwenden Sie Tailwind-RTL-Varianten für Ausnahmen, nicht als Standard
Die rtl:-Variante von Tailwind wendet ein Utility an, wenn die geerbte Richtung rechts-nach-links ist. Die offizielle Dokumentation zu state variants ist die Quelle für Syntax und Reihenfolge. Logische Spacing-Utilities wie ms-* und me-* sollten den größten Teil der Arbeit übernehmen; rtl: ist der Escape-Hatch für eine richtungsabhängige Ausnahme.
export function NextStepButton() {
return (
<button className="inline-flex items-center gap-2 px-4 py-2 rtl:flex-row-reverse">
<span>Continue</span>
<svg
aria-hidden="true"
viewBox="0 0 20 20"
className="size-4 rtl:rotate-180"
>
<path d="M7 4l6 6-6 6" fill="none" stroke="currentColor" strokeWidth="2" />
</svg>
</button>
);
}
Wenden Sie nicht rtl:rotate-180 auf jedes Icon an. Ein Chevron für „weiter“ ist richtungsabhängig; ein Logo, eine Uhr, ein Produktbild und ein Play-Dreieck sind es nicht. Die Regel ist semantisch: Drehen Sie ein Icon nur, wenn seine Bedeutung von der Lesrichtung abhängt. Dieselbe Disziplin gilt für Charts, Timelines, Fortschrittsindikatoren und Drag-and-Drop-Oberflächen, wo eine blinde Spiegelung die Daten statt des Layouts umkehren kann.
Prüfen Sie eigene Komponenten und eingebettete Inhalte
Third-Party-Komponenten erben dir vom Dokument, aber Vererbung garantiert nicht, dass ihr internes Layout korrekt ist. Radix-basierte Primitives, Date-Picker, Rich-Text-Editoren, Carousels und virtualisierte Tabellen brauchen einen eigenen Durchgang. Eine Komponente, die die Root-Richtung respektiert, kann trotzdem einen fest codierten Transform oder eine feste Position enthalten.
Eingebettete iframes und Third-Party-Widgets sind separate Dokumente. Wenn das Widget richtungssensitiv ist, setzen Sie sein eigenes dir, wo der Anbieter das unterstützt. Verlassen Sie sich nicht darauf, dass die Elternseite ein Cross-Origin-Dokument repariert.
Testen Sie RTL an der Verhaltensgrenze
Prüfen Sie zuerst den Dokumentvertrag
Ein schneller Test soll fehlschlagen, wenn die Seite nicht die richtige Sprache und Richtung deklariert. Das findet Routing-Fehler, ein fehlendes Server-Attribut und einen Locale-Switcher, der die URL aktualisiert, aber nicht das Dokument.
import { test, expect } from "@playwright/test";
test("Arabic checkout declares RTL and preserves the primary action", async ({ page }) => {
await page.goto("/ar/checkout");
await expect(page.locator("html")).toHaveAttribute("lang", "ar");
await expect(page.locator("html")).toHaveAttribute("dir", "rtl");
await expect(page).toHaveScreenshot("checkout-ar.png", { fullPage: true });
});
Die Dokumentation zu visuellen Vergleichen von Playwright erklärt die Erzeugung und Aktualisierung von Baselines. Halten Sie Screenshots auf einen stabilen Viewport und ein deterministisches Font-Setup beschränkt. Ein Screenshot, der sich ändert, weil ein remote Font spät geladen wurde, lehrt das Team, Fehler zu ignorieren.
Testen Sie Verhalten, nicht nur Pixel
Ein Snapshot kann bestätigen, dass eine Seite so aussieht wie die zuletzt freigegebene Baseline, aber er kann nicht sagen, ob die Baseline korrekt war. Ergänzen Sie Assertions für die Verhaltensweisen, die zählen: Der Drawer öffnet sich von der Inline-End-Kante, Formularlabels richten sich an der Start-Kante aus, der primäre Button bleibt erreichbar, und ein langer arabischer String clippt seinen Container nicht.
Verwenden Sie eine echte RTL-Locale für mindestens einen End-to-End-Pfad. Pseudo-Lokalisierung ist nützlich, um fest codierte Strings zu finden, aber sie übt keine arabische Schriftdarstellung, keine Bidi-Textläufe und keine rechts-nach-links-Navigation aus. Kombinieren Sie für öffentliche lokalisierte Seiten den UI-Test mit Canonical- und hreflang-Checks; der hreflang-Implementierungsleitfaden behandelt die suchseitige Seite, die vom Layout getrennt ist.
Was Screenshots nicht beweisen
Visuelle Tests beweisen keine Übersetzungsqualität. Sie finden keine maschinelle Übersetzung, die eine rechtliche Bedeutung umkehrt, kein Währungssymbol auf der falschen Seite und keinen Namen, der nicht übersetzt werden dürfte. Sie beweisen auch nicht, dass das Locale-Routing indexierbar ist. Testen Sie diese Punkte mit eigenen Assertions, statt einen Layout-Snapshot über das hinaus zu dehnen, was er belegen kann.
Welche SaaS-Template-Fähigkeit unterstützt das?
Hier wird die Implementierungsfrage zur Kaufentscheidung. Ein RTL-fähiges Template braucht mehr als ein Sprach-Dropdown. Es braucht eine Richtungsgrenze am Dokument-Root, eine Locale-Routing-Strategie, einen Übersetzungskatalog, der RTL-Locales darstellen kann, und eine Testumgebung, die Richtung prüfen kann. Wenn Sie einen Startpunkt wählen, vergleichen Sie SaaS-Templates und Boilerplates an diesen Fähigkeiten statt an der Zahl der Flags im Header.
Auch die architektonische Wahl hinter den Strings zählt. Ein kompilierter Katalog, ein CMS, ein datenbankgestützter Katalog und ein Hybrid ändern jeweils, wer eine Übersetzung ausliefern kann und wann. Der i18n-Architekturvergleich erklärt diese Trade-offs; nutzen Sie ihn, um zu entscheiden, was das Template bereitstellen muss, bevor Sie seine UI prüfen.
Eine nützliche Anbieterfrage lautet: „Zeigen Sie mir die Datei, die dir setzt, die Datei, die die Locale auflöst, und den Test, der den RTL-Pfad beweist.“ Wenn die Antwort ein Screenshot einer arabischen Landingpage ohne Route, ohne Dokumentattribute und ohne Test ist, hat das Template eine Demo, keine Grundlage. Wenn Sie zuerst die Produktflächen prüfen wollen, stöbern Sie in TanStack-Templates, bevor Sie sich auf einen Build festlegen.
Käufer-Checkliste für ein RTL-fähiges Template
| Fähigkeit | Artefakt, das Sie anfordern sollten | Warum es zählt |
|---|---|---|
| Locale-Routing | Route-Tabelle oder URL-Beispiele wie /ar/... | Die Richtung kann nicht korrekt sein, wenn die Locale nicht adressierbar ist |
| Dokumentrichtung | Root-Shell, die lang und dir rendert | Verhindert ein Umspringen beim ersten Paint |
| Logisches CSS | Spacing- und Border-Regeln mit inline Properties | Reduziert den Wartungsaufwand pro Komponente |
| Ausnahmen-Politik | Liste der Icons, die bewusst nicht gespiegelt werden | Verhindert blinde Spiegelung |
| Testabdeckung | Playwright-Test mit RTL-Locale und Screenshot | Macht Regressionsfehler sichtbar |
| SEO-Behandlung | Canonical- und hreflang-Strategie für öffentliche Seiten | Trennt Layout von Indexierbarkeit |
Implementierungs-Checkliste
- Erfassen Sie jede Locale, die Sie unterstützen, und ihre Richtung in einem gemeinsamen Manifest.
- Rendern Sie
langunddiram Root-Element an der Server-Grenze. - Ersetzen Sie physische Margins, Padding, Rahmen, Insets und Textausrichtung durch logical properties.
- Prüfen Sie Drawer, Menüs, Tooltips und Floating-Actions mit fester Positionierung auf Inline-Start- und Inline-End-Annahmen.
- Markieren Sie richtungsabhängige Icons explizit; lassen Sie Logos, Uhren und Medienbilder unberührt.
- Testen Sie einen vollständigen Flow in einer echten RTL-Locale, inklusive eines langen Strings und eines Validierungsfehlers.
- Ergänzen Sie eine visuelle Baseline, die das Team in Pull Requests tatsächlich prüft.
- Prüfen Sie Locale-Routing, Canonical-Tags und
hreflang, bevor Sie lokalisierte Seiten veröffentlichen. - Dokumentieren Sie die Ausnahmen, die Custom CSS benötigen, damit die nächste Person nicht raten muss.
Einschränkungen und Offenlegung
Einschränkungen: Ich habe keine arabische Produktionsoberfläche ausgeliefert, deshalb veröffentlicht dieser Artikel kein Conversion-, Retention- oder Performance-Ergebnis. Er misst keinen Bundle-Size-Effekt durch Tailwind-Varianten und behauptet nicht, dass eine bestimmte Komponentenbibliothek jede RTL-Interaktion unterstützt. Die Browser-Unterstützung für neuere APIs ändert sich; prüfen Sie die Features, die Sie übernehmen, anhand der aktuellen Primärdokumentation und Ihrer unterstützten Browser-Matrix. Die Implementierungsgrenze hier ist CSS, HTML-Richtung und Teststrategie, nicht Übersetzungsqualität oder regionales Zahlungsverhalten.
Offenlegung: TanStack Ship veröffentlicht diesen Blog und verkauft Templates. Kein Anbieter hat für eine Platzierung in diesem Artikel bezahlt. Produktlinks sind kontextbezogen und ändern die technische Empfehlung nicht. Korrekturen sind im Changelog datiert; melden Sie sachliche Fehler über den Kontaktweg auf der About-Seite.
In diesem Artikel verwendete Claim-Labels: Gemessen bedeutet Daten aus dem gelieferten Search-Console-Datensatz oder direkt beobachtbares Browserverhalten. Nutzerbereitgestellt bedeutet den Themen-Datensatz, der die Suchanfrage gerahmt hat. Berechnet bedeutet Arithmetik aus diesen Eingaben; hier gibt es keine berechneten Performance-Aussagen. Geschätzt bedeutet eine Annahme über Ihre Anwendung, und keine wird als Benchmark präsentiert. Proxy bedeutet ein indirektes Signal — die Suchposition ist ein Proxy für Sichtbarkeit, kein Beweis dafür, dass eine Layoutänderung die Conversion verbessert.
FAQ
Unterstützt React RTL sofort nach der Installation?
React rendert die Attribute dir und lang, die Sie bereitstellen, wählt aber keine Richtung und schreibt Ihr CSS nicht um. Sie müssen die Dokumentattribute aus der aktiven Locale setzen und richtungsbewusste Layoutregeln schreiben. Die Referenz zu häufigen Komponentenattributen von React dokumentiert die DOM-Attribute; die Locale-Entscheidung gehört zu Ihrer Anwendung.
Sollte ich dir="rtl" auf dem body oder dem html-Element setzen?
Setzen Sie es nach Möglichkeit auf dem html-Element, weil es die Basisrichtung für das gesamte Dokument festlegt. Ein verschachtelter Container kann die Richtung für einen bestimmten Bereich überschreiben, aber der Start am Root vermeidet inkonsistente Vererbung. Setzen Sie auch lang; Richtung und Sprache lösen unterschiedliche Probleme.
Reicht Tailwinds rtl:-Variante für RTL-Support?
Nein. Die Variante ist für Ausnahmen nützlich, etwa richtungsabhängige Icons und ungewöhnliche Flex-Reihenfolgen, aber das normale Layout sollte auf logical properties ruhen. Wenn der Großteil Ihres CSS von rtl:-Overrides abhängt, sind die zugrunde liegenden Regeln weiterhin aus einer Links-nach-rechts-Annahme geschrieben und schwerer zu pflegen.
Wie teste ich React RTL, ohne Arabisch zu sprechen?
Verwenden Sie eine echte RTL-Locale für mindestens einen End-to-End-Pfad, auch wenn Sie einen Übersetzer für die Textprüfung brauchen. Automatisierte Tests können dir, lang, berechnete Ausrichtung und Screenshots ohne Sprachkenntnisse prüfen, aber ein muttersprachlicher Reviewer bleibt für Bedeutung, Ton und kulturspezifische Formatierung nötig. Betrachten Sie einen grünen Test nicht als Übersetzungsreview.
Fazit
Die Implementierungsentscheidung ist klar: Setzen Sie die Richtung am Dokument-Root, verlagern Sie das Layout auf logisches CSS, reservieren Sie rtl:-Varianten für semantische Ausnahmen und testen Sie eine echte RTL-Route. Die Kaufentscheidung ist, ob Ihr Startpunkt diese Grenze bereits enthält oder ob Sie sie neu bauen müssen.
Nächster Schritt: Vergleichen Sie SaaS-Templates und Boilerplates an ihrer dokumentierten RTL-, Locale-Routing- und Test-Fähigkeit, bevor Sie einen Starter kaufen oder eine weitere Komponentenbibliothek ergänzen.