Communitygithub.com

RTL-Komponentenmuster

RTL-korrekte Komponentenmuster mit Tailwind Logical Utilities. Verwenden Sie dies beim Erstellen von Formularen, Karten, Navigation, Tabellen, Modalen, Paginierung, Breadcrumbs oder jeder UI-Komponente für persische/arabische RTL-Seiten oder beim Beheben von gespiegelten Layout-Fehlern. Deckt ms/me/ps/pe-Utilities, Icon-Flipping, Sidebar-Platzierung und shadcn/ui RTL-Hinweise ab.

Was ist RTL-Komponentenmuster?

Diese Skill-Anleitung bietet ein umfassendes Regelwerk zum Erstellen von RTL-korrekten UI-Komponenten mit Tailwind CSS und shadcn/ui. Sie enthält eine Übersetzungstabelle für LTR-Gewohnheiten in logische, richtungsunabhängige Utilities wie `ms-` statt `mr-` und `start-0` statt `left-0`. Zudem wird erklärt, welche Icons (z. B. Chevrons, Pfeile) gespiegelt werden müssen und welche nicht (z. B. Uhr, Schloss). Die Anleitung deckt Formulare, Navigation (Sidebar, Breadcrumbs, Paginierung), Overlays (Dialogs, Sheets, Tooltips), Karten und Animationen ab. Besonderes Augenmerk liegt auf CSS-Transformationen, die nicht automatisch von `dir` gespiegelt werden – hier werden explizite RTL-Zwillinge oder logische Eigenschaften wie `inset-inline-start` empfohlen. Abschließend gibt es shadcn/ui-spezifische Hinweise und eine Audit-Checkliste (`rtl-audit`). Entwickler, die mehrsprachige Anwendungen mit RTL-Sprachen wie Persisch oder Arabisch erstellen, können diese Skill verwenden, um typische Layout-Fehler zu vermeiden und eine konsistente Benutzererfahrung zu gewährleisten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mhmdsdqi87-cloud/TEKA_raast/tree/HEAD/skills/rtl-components

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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-GewohnheitLogisch (immer verwenden)
ml- / mr-ms- / me-
pl- / pr-ps- / pe-
left-0 / right-0start-0 / end-0
text-left / text-righttext-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-end fü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 pr hartcodieren.
  • Validierungs-Icons: mit end-0 statt right-0 platzieren.
  • 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. Prev ist visuell auf der rechten Seite.
  • Tabs: Reihenfolge verläuft rechts → links; aktive Unterstreichung via border-b ist in Ordnung.
  • Tabelle: Spaltenreihenfolge spiegelt sich automatisch; nummerische Zellen mit text-end ausrichten 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-w gesetzt 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-2 oder flex gap-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-Zwilling
  • rotate-45 dekorativ → normalerweise in Ordnung
  • Karussell-Wischbewegung: embla/swiper – Option direction: rtl setzen, sonst scrollen sie rückwärts
  • Fortschrittsbalken: Füllung verankert an start-0, wächst nach links; Prozentangaben als ۷۰٪
  • Skeleton-Shimmer: keyframe translate-x muss 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 sollte ChevronDown sein (richtungsfrei, keine Änderung); InputOTP, CommandDialog und ResizablePanel erfordern 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.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Verwandte Skills