RTL-Komponentenmuster (Tailwind + shadcn/ui)
Logische, richtungsunabhängige Komponenten. Nach dir="rtl" spiegeln sich Flex/Grid automatisch – die Fehler stecken in den hier aufgelisteten Überbleibseln.
1. Utility-Übersetzungstabelle (auswendig lernen)
| LTR-Gewohnheit | Logisch (immer verwenden) |
|---|---|
ml- / mr- | ms- / me- |
pl- / pr- | ps- / pe- |
left-0 / right-0 | start-0 / end-0 |
text-left / text-right | text-start / text-end |
border-l- / border-r- | border-s- / border-e- |
rounded-l- / rounded-r- | rounded-s- / rounded-e- |
ml-auto (auf die ferne Seite schieben) | ms-auto |
Diese gibt es in Tailwind v3.3+ und v4. Sie zu verwenden bedeutet, dass die Komponente kostenlos in BEIDEN Richtungen funktioniert.
2. Richtungsabhängige Icons – die Flip-Liste
NUR wirklich richtungsabhängige Icons flippen. Niemals semantisch stabile flippen.
Flip (rtl:-scale-x-100 oder vor-geflipptes SVG, oder rtl:rotate-180 für Pfeile):
- Chevrons/Pfeile für Weiter/Zurück, Zurück-Buttons, Breadcrumb-Trennzeichen
- Einrücken/Ausrücken, Antworten (Teilen-Pfeil), Weiterleiten, Wiederholen
- Zeitachsen-Markierungen, „Seitenleiste erweitern“-Icons
Nicht flippen:
- Uhr, Schloss, Suche, Einstellungen, Haken, Herz, Stern, Hochladen/Herunterladen, WLAN, Glocke
<!-- Nächster Pfeil zeigt in RTL nach links -->
<svg class="rtl:rotate-180">…</svg>
Für shadcn/ui + lucide: <ChevronLeft className="rtl:rotate-180" /> ist zweimal falsch – stattdessen einfach das korrekte Glyph für die ausgelieferte Richtung verwenden. Für ein reines RTL-Produkt: nächster = ChevronLeft, zurück = ChevronRight.
3. Formulare
- Labels sitzen am Inline-Start oberhalb des Eingabefelds (Standard).
- Texteingaben:
dir="auto"für Name/Nachricht;dir="ltr"+text-endfür Telefon, E-Mail, Personalausweisnummer, Preiseingaben (Inhalt ist LTR, aber Platzierung bleibt rechts). - Eingabegruppen-Addons: Währung «تومان» nach der Zahl → visuell links; logisches Padding auf beiden Seiten verwenden, niemals
prhartcodieren. - Validierungs-Icons: mit
end-0stattright-0platzieren. - Fehlertexte: Persisch, mit «؛» und korrektem ZWNJ: «ایمیل معتبر نیست»، «رمز عبور باید ۸ نویسه یا بیشتر باشد».
4. Navigation & Chrome
- Sidebar:
start-0(rendert in RTL rechts). Komprimierte Variante nur mit Symbolen behält Tooltip-Flipping (side="start"in Radix-Tooltips). - Breadcrumbs: Trennzeichen =
ChevronLeft(RTL „vorwärts-ab“-Richtung), letztes Element aktuell. - Paginierung: Seitenzahlen steigen nach LINKS auf: ۱ ۲ ۳ ۴ mit nächstem = ChevronLeft.
Previst visuell auf der rechten Seite. - Tabs: Reihenfolge verläuft rechts → links; aktive Unterstreichung via
border-bist in Ordnung. - Tabelle: Spaltenreihenfolge spiegelt sich automatisch; nummerische Zellen mit
text-endausrichten und persischen Ziffern ihre eigenen LTR-Läufe lassen.
5. Overlays
- Dialoge/Sheets:
Sheet side="start"= Schublade auf der rechten Seite in RTL-Seiten. - Dropdown/Popover: Radix verwendet
side/align–align="start"folgt dem Inline-Start (rechts). Standard-Kollision funktioniert gut mit RTL. - Toasts: Position
bottom-start(visuell unten rechts für RTL), damit sie nicht mit CTAs am Inline-Ende kollidieren. - Tooltips bei abgeschnittenem persischen Text: Radix misst korrekt; sicherstellen, dass
max-wgesetzt ist – persische Auslassungspunkte funktionieren normal.
6. Karten & Inhaltsblöcke
- Akzentbalken an der Inline-Start-Kante:
border-s-2 border-s-emerald-500(rendert auf der rechten Seite). - Meta-Zeilen (Autor · Datum · Lesezeit): Trennpunkt mit
ms-2 me-2oder flexgap-2. - Karten mit Aktionen: Primäre Aktion am Inline-Ende? Nein – in RTL-Leserichtung sitzt der primäre CTA konventionell am Inline-ENDE (links) in Kartenfüßen, als Spiegelung der LTR-Konventionen.
7. Bewegung & Transformationen
dir spiegelt NICHT Transformationen. Überprüfe jedes:
translate-x-*(Schieberegler, Off-Canvas, Laufbänder) → benötigt einen expliziten RTL-Zwillingrotate-45dekorativ → normalerweise in Ordnung- Karussell-Wischbewegung: embla/swiper – Option
direction: rtlsetzen, sonst scrollen sie rückwärts - Fortschrittsbalken: Füllung verankert an
start-0, wächst nach links; Prozentangaben als ۷۰٪ - Skeleton-Shimmer: keyframe
translate-xmuss sich spiegeln, sonst gleitet der Shimmer in die falsche Richtung
Richtungsbewusste Animationsmuster
/* Off-Canvas-Schublade: kommt von Inline-Start, verlässt zu Inline-Start.
Ein Deklarationspaar bedient beide Richtungen. */
.drawer { transform: translateX(calc(var(--dir-sign, -1) * 100%)); }
[dir="rtl"] .drawer { --dir-sign: 1; }
.drawer.open { transform: translateX(0); }
/* Spring-/Hervorhebungs-Icons: die gesamte Animation flippen, nicht das Element während des Flugs */
[dir="rtl"] .cta-arrow { animation: nudge-rtl 1.2s infinite; }
@keyframes nudge-rtl { 50% { transform: translateX(-4px); } }
/* Zahlenzähler und Fortschrittsfüllung: die logische Inline-Größe animieren, nicht left */
@keyframes fill { from { inline-size: 0 } }
- CSS logisches
inset-inline-start+ benutzerdefinierter Eigenschafts-Vorzeichenwechsel schlägt das Duplizieren ganzer Keyframes pro Richtung. prefers-reduced-motion: reduce→ Nudges/Marquees deaktivieren, Opazitäts-Überblendungen behalten.
8. shadcn/ui RTL-Hinweise (v4 Tokens, New York-Stil)
- Die meisten Primitiven sind RTL-sauber, wenn die App
dir="rtl"auf<html>setzt. - Bekannte Nachbesserungen:
DropdownMenuContent align="start"hält Menüs unter der rechten Kante des Triggers verankert;Select-Chevron sollteChevronDownsein (richtungsfrei, keine Änderung);InputOTP,CommandDialogundResizablePanelerfordern manuelle Überprüfung. - Schrift-Tokens einmal setzen: Vazirmatn in
--font-sans(globals.css) eintragen, damit jede shadcn-Komponente sie erbt.
9. Audit-Haken
Komponenten durch die rtl-audit-Checkliste schicken – besonders Icon-Flips, Transformationen und left/right-Klassen.