Patrones de Componentes RTL (Tailwind + shadcn/ui)
Componentes lógicos e independientes de la dirección. Después de dir="rtl", flex/grid se reflejan automáticamente — los errores están en los detalles restantes que se enumeran aquí.
1. Tabla de traducción de utilidades (memorizar esto)
| Hábito LTR | Lógico (usar siempre) |
|---|---|
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 (empujar al lado lejano) | ms-auto |
Estas utilidades existen en Tailwind v3.3+ y v4. Usarlas significa que el componente funciona en AMBAS direcciones sin esfuerzo adicional.
2. Iconos direccionales — la lista de volteo
Voltea ÚNICAMENTE los iconos verdaderamente direccionales. Nunca voltees los que son semánticamente estables.
Voltear (rtl:-scale-x-100 o SVG pre-volteado, o rtl:rotate-180 para flechas):
- chevrones/flechas para siguiente/anterior, botones de retroceso, separadores de migas de pan
- sangría/desangría, responder (flecha de compartir), reenviar, rehacer
- marcadores de línea de tiempo, iconos de "expandir panel lateral"
NO voltear:
- reloj, candado, búsqueda, configuración, check, corazón, estrella, subir/bajar, wifi, campana
<!-- la flecha siguiente en RTL apunta a la izquierda -->
<svg class="rtl:rotate-180">…</svg>
Para shadcn/ui + lucide: <ChevronLeft className="rtl:rotate-180" /> está mal dos veces — en su lugar, usa el glifo correcto para la dirección que sirves. Para un producto solo RTL: siguiente = ChevronLeft, atrás = ChevronRight.
3. Formularios
- Las etiquetas se colocan al inicio en línea (inline-start) encima del campo de entrada (estándar).
- Entradas de texto:
dir="auto"para nombre/mensaje;dir="ltr"+text-endpara teléfono, correo electrónico, ID nacional, entradas de precio (el contenido es LTR pero la ubicación permanece a la derecha). - Complementos de grupo de entrada: moneda «تومان» después del número → lado visual izquierdo; usa relleno lógico en ambos lados, nunca codifiques
pr. - Iconos de validación: colócalos con
end-0, no conright-0. - Texto de error: en persa, con «؛» y ZWNJ correcto: «ایمیل معتبر نیست»، «رمز عبور باید ۸ نویسه یا بیشتر باشد».
4. Navegación & Chrome
- Barra lateral:
start-0(se renderiza a la derecha en RTL). La variante colapsada solo con icono mantiene los tooltips volteados (side="start"en tooltips de Radix). - Migas de pan: separador =
ChevronLeft(dirección "hacia adelante" en RTL), último elemento actual. - Paginación: los números de página ascienden hacia la IZQUIERDA: ۱ ۲ ۳ ۴ con siguiente = ChevronLeft. "Anterior" está en el lado derecho visualmente.
- Pestañas: el orden fluye de derecha a izquierda; la línea activa mediante
border-bestá bien. - Tabla: el orden de las columnas se refleja automáticamente; alinea las celdas numéricas con
text-endy deja que los números en dígitos persas mantengan sus propias secuencias LTR.
5. Superposiciones
- Diálogos/Hojas:
Sheet side="start"= cajón del lado derecho en páginas RTL. - Desplegables/Popover: Radix usa
side/align—align="start"sigue el inicio en línea (derecha). La colisión predeterminada funciona bien con RTL. - Notificaciones (Toasts): posición
bottom-start(visualmente abajo a la derecha para RTL) para que no interfieran con los CTAs al final en línea. - Tooltips en texto persa truncado: Radix mide bien; asegúrate de establecer
max-w— los puntos suspensivos en persa funcionan normalmente.
6. Tarjetas & Bloques de contenido
- Barra de acento en el borde de inicio en línea:
border-s-2 border-s-emerald-500(se renderiza a la derecha). - Filas de metadatos (autor · fecha · tiempo de lectura): punto separador con
ms-2 me-2o flexgap-2. - Tarjetas con acciones: ¿acción principal al final en línea? No — en la lectura RTL, el CTA principal se sitúa convencionalmente al final en línea (izquierda) en los pies de tarjeta, reflejando las convenciones LTR.
7. Movimiento & Transformaciones
dir NO refleja las transformaciones. Audita cada:
translate-x-*(deslizadores, fuera de lienzo, marquesina) → necesita un gemelo explícito para RTLrotate-45decorativo → generalmente bien- Deslizamiento de carrusel: embla/swiper — establece la opción
direction: rtlo se desplazarán hacia atrás - Barras de progreso: relleno anclado en
start-0, crece hacia la izquierda; porcentajes como ۷۰٪ - Brillo de esqueleto: el
translate-xdel keyframe debe reflejarse o el brillo se deslizará en la dirección equivocada
Patrones de animación sensibles a la dirección
/* Cajón fuera de lienzo: entra desde el inicio en línea, sale hacia el inicio en línea.
Un par de declaraciones sirve para ambas direcciones. */
.drawer { transform: translateX(calc(var(--dir-sign, -1) * 100%)); }
[dir="rtl"] .drawer { --dir-sign: 1; }
.drawer.open { transform: translateX(0); }
/* Iconos de rebote / énfasis: voltea la animación completa, no el elemento a medio vuelo */
[dir="rtl"] .cta-arrow { animation: nudge-rtl 1.2s infinite; }
@keyframes nudge-rtl { 50% { transform: translateX(-4px); } }
/* Contadores numéricos y relleno de progreso: anima el tamaño lógico en línea, no left */
@keyframes fill { from { inline-size: 0 } }
- El
inset-inline-startlógico de CSS + el cambio de signo de propiedad personalizada es mejor que duplicar keyframes completos por dirección. prefers-reduced-motion: reduce→ deshabilitar nudges/marquesinas, mantener fundidos de opacidad.
8. Notas de shadcn/ui para RTL (tokens v4, estilo New York)
- La mayoría de los primitivos son limpios para RTL cuando la aplicación establece
dir="rtl"en<html>. - Retoques conocidos:
DropdownMenuContent align="start"mantiene los menús anclados debajo del borde derecho del disparador; el chevron deSelectdebe serChevronDown(sin dirección, sin cambios);InputOTP,CommandDialogyResizablePanelnecesitan revisión manual. - Establece los tokens de fuente una vez: pon Vazirmatn en
--font-sans(globals.css) para que cada componente de shadcn lo herede.
9. Gancho de auditoría
Envía los componentes a través de la lista de verificación rtl-audit — especialmente los volteos de iconos, transformaciones y clases left/right.