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 LTR | Logique (à utiliser toujours) |
|---|---|
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 (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-endpour 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-0pasright-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.
Prevest visuellement sur le côté droit. - Onglets : l'ordre s'écoule de droite à gauche ; le soulignement actif via
border-best correct. - Tableau : l'ordre des colonnes se reflète automatiquement ; alignez les cellules numériques
text-endet 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-west 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-2ou flexgap-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 expliciterotate-45décoratif → généralement correct- Glissement de carrousel : embla/swiper — définissez l'option
direction: rtlou ils défilent à l'envers - Barres de progression : remplissage ancré à
start-0, croît vers la gauche ; pourcentages en ۷۰٪ - Skeleton shimmer :
translate-xde 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-startlogique 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 ;Selectchevron doit êtreChevronDown(sans direction, aucun changement) ;InputOTP,CommandDialogetResizablePanelné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.