Communitygithub.com

rtl-components

Modèles de composants compatibles RTL avec les utilitaires logiques Tailwind. À utiliser lors de la création de formulaires, cartes, navigation, tableaux, modales, pagination, fils d'Ariane ou tout composant d'interface utilisateur pour les pages persanes/arabes RTL, ou pour corriger les bugs de mise en page miroir. Couvre les utilitaires ms/me/ps/pe, le retournement des icônes, le placement de la barre latérale et les notes RTL de shadcn/ui.

Qu'est-ce que rtl-components ?

Ce skill fournit un guide complet pour créer des composants d'interface utilisateur adaptés aux directions d'écriture RTL (de droite à gauche) comme le persan ou l'arabe, en utilisant Tailwind CSS et shadcn/ui. Il explique comment remplacer les propriétés de direction physique (comme `mr-`/`ml-`) par leurs équivalents logiques (`ms-`/`me-`) pour garantir un fonctionnement correct dans les deux sens. Le skill détaille également le retournement sélectif des icônes, la gestion des formulaires, de la navigation, des superpositions, des animations et des composants shadcn/ui spécifiques. Il est utile pour tout développeur travaillant sur des applications multilingues ou spécifiquement RTL, en évitant les bugs de mise en page miroir et en assurant une expérience utilisateur cohérente.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Modèles de composants RTL (Tailwind + shadcn/ui)

Composants logiques et indépendants de la direction. Après dir="rtl", flex/grid se reflètent automatiquement — les bugs résident dans les éléments restants listés ici.

1. Table de traduction des utilitaires (à mémoriser)

Habitude LTRLogique (à utiliser toujours)
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 (pousser vers le côté extrême)ms-auto

Ces utilitaires existent dans Tailwind v3.3+ et v4. Les utiliser garantit que le composant fonctionne dans les DEUX directions sans effort.

2. Icônes directionnelles — la liste de retournement

Ne retourner QUE les icônes vraiment directionnelles. Ne jamais retourner celles qui sont sémantiquement stables.

Retourner (rtl:-scale-x-100 ou SVG pré-retourné, ou rtl:rotate-180 pour les flèches) :

  • chevrons/flèches pour suivant/précédent, boutons retour, séparateurs de fil d'Ariane
  • retrait/désindentation, réponse (flèche de partage), transférer, refaire
  • marqueurs de chronologie, icônes "développer le panneau latéral"

Ne PAS retourner :

  • horloge, verrou, recherche, paramètres, coche, cœur, étoile, téléchargement/téléversement, wifi, cloche
<!-- flèche suivante en RTL pointe vers la gauche -->
<svg class="rtl:rotate-180">…</svg>

Pour shadcn/ui + lucide : <ChevronLeft className="rtl:rotate-180" /> est deux fois faux — utilisez plutôt le glyphe correct pour la direction que vous servez. Pour un produit uniquement RTL : suivant = ChevronLeft, retour = ChevronRight.

3. Formulaires

  • Les étiquettes se trouvent au début de la ligne au-dessus du champ (standard).
  • Champs de texte : dir="auto" pour le nom/message ; dir="ltr" + text-end pour le téléphone, l'e-mail, l'identifiant national, les saisies de prix (le contenu est LTR mais le placement reste à droite).
  • Extensions de groupe de saisie : devise « تومان » après le nombre → visuellement à gauche ; utilisez un remplissage logique des deux côtés, ne codez jamais en dur pr.
  • Icônes de validation : placez avec end-0 pas right-0.
  • Texte d'erreur : en persan, avec « ; » et ZWNJ correct : « ایمیل معتبر نیست », « رمز عبور باید ۸ نویسه یا بیشتر باشد ».

4. Navigation & chrome

  • Barre latérale : start-0 (s'affiche à droite en RTL). La variante réduite avec icônes conserve les info-bulles retournées (side="start" dans les info-bulles Radix).
  • Fils d'Ariane : séparateur = ChevronLeft (direction "avant-bas" en RTL), dernier élément actuel.
  • Pagination : les numéros de page montent vers la GAUCHE : ۱ ۲ ۳ ۴ avec suivant = ChevronLeft. Prev est visuellement sur le côté droit.
  • Onglets : l'ordre s'écoule de droite à gauche ; le soulignement actif via border-b est correct.
  • Tableau : l'ordre des colonnes se reflète automatiquement ; alignez les cellules numériques text-end et laissez les nombres en chiffres persans suivre leur propre séquence LTR.

5. Superpositions

  • Dialogues/Fiches : Sheet side="start" = tiroir côté droit dans les pages RTL.
  • Menu déroulant/Popover : Radix utilise side/align — align="start" suit le début de la ligne (droite). La collision par défaut fonctionne correctement avec le RTL.
  • Toasts : position bottom-start (visuellement en bas à droite pour RTL) pour qu'ils ne gênent pas les CTA à la fin de la ligne.
  • Info-bulles sur du texte persan tronqué : Radix mesure correctement ; assurez-vous que max-w est défini — les points de suspension persans fonctionnent normalement.

6. Cartes & blocs de contenu

  • Barre d'accentuation sur le bord de début de ligne : border-s-2 border-s-emerald-500 (s'affiche à droite).
  • Lignes de méta (auteur · date · temps de lecture) : point de séparation avec ms-2 me-2 ou flex gap-2.
  • Cartes avec actions : action principale à la fin de la ligne ? Non — en lecture RTL, le CTA principal se trouve conventionnellement à la fin de la ligne (gauche) dans les pieds de carte, en miroir des conventions LTR.

7. Mouvement & transformations

dir ne reflète PAS les transformations. Vérifiez chaque :

  • translate-x-* (curseurs, hors-champ, marquee) → nécessite un jumeau RTL explicite
  • rotate-45 décoratif → généralement correct
  • Glissement de carrousel : embla/swiper — définissez l'option direction: rtl ou ils défilent à l'envers
  • Barres de progression : remplissage ancré à start-0, croît vers la gauche ; pourcentages en ۷۰٪
  • Skeleton shimmer : translate-x de l'image clé doit se refléter ou le scintillement glisse dans le mauvais sens

Modèles d'animation tenant compte de la direction

/* Tiroir hors-champ : entre depuis le début de la ligne, sort vers le début de la ligne.
   Une paire de déclarations sert les deux directions. */
.drawer { transform: translateX(calc(var(--dir-sign, -1) * 100%)); }
[dir="rtl"] .drawer { --dir-sign: 1; }
.drawer.open { transform: translateX(0); }

/* Icônes de rebond / accent : retournez toute l'animation, pas l'élément en vol */
[dir="rtl"] .cta-arrow { animation: nudge-rtl 1.2s infinite; }
@keyframes nudge-rtl { 50% { transform: translateX(-4px); } }

/* Compteurs numériques et remplissage de progression : animez la taille logique en ligne, pas left */
@keyframes fill { from { inline-size: 0 } }
  • inset-inline-start logique CSS + commutateur de signe de propriété personnalisée bat la duplication d'images clés entières par direction.
  • prefers-reduced-motion: reduce → désactivez les nudges/marquees, conservez les fondus d'opacité.

8. Notes RTL de shadcn/ui (jetons v4, style New York)

  • La plupart des primitives sont compatibles RTL lorsque l'application définit dir="rtl" sur <html>.
  • Retouches connues : DropdownMenuContent align="start" maintient les menus ancrés sous le bord droit du déclencheur ; Select chevron doit être ChevronDown (sans direction, aucun changement) ; InputOTP, CommandDialog et ResizablePanel nécessitent une vérification manuelle.
  • Définissez les jetons de police une fois : mettez Vazirmatn dans --font-sans (globals.css) pour que chaque composant shadcn l'hérite.

9. Accroche d'audit

Livrez les composants en passant par la liste de contrôle rtl-audit — en particulier les retournements d'icônes, les transformations et les classes left/right.

Individual skills in this repo

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

Skills associés