Communitygithub.com

rtl-components

Patrones de componentes compatibles con RTL usando utilidades lógicas de Tailwind. Útil al construir formularios, tarjetas, navegación, tablas, modales, paginación, migas de pan o cualquier componente de interfaz para páginas en persa/árabe con RTL, o al corregir errores de diseño reflejados. Cubre utilidades ms/me/ps/pe, volteo de iconos, colocación de barras laterales y notas de shadcn/ui para RTL.

¿Qué es rtl-components?

Este skill proporciona un conjunto completo de patrones y directrices para crear componentes de interfaz de usuario que funcionen correctamente tanto en direcciones de texto LTR como RTL, utilizando las utilidades lógicas de Tailwind CSS. Está diseñado para desarrolladores que trabajan con frameworks como React, Vue, o Astro, y bibliotecas de componentes como shadcn/ui, Radix UI, y Lucide. La funcionalidad principal se basa en la traducción de propiedades CSS direccionales (como `left`/`right` o `margin-left`/`margin-right`) a sus equivalentes lógicos (`start`/`end`, `ms`/`me`), asegurando que los componentes se reflejen automáticamente al cambiar el atributo `dir="rtl"` en el HTML. Además, incluye reglas específicas para el volteo de iconos direccionales (como flechas y chevrones), el manejo de formularios con entradas de texto mixtas (persa y números LTR), la disposición correcta de barras laterales, migas de pan, paginación y superposiciones como diálogos y tooltips. También cubre animaciones y transformaciones CSS, ofreciendo patrones para animaciones responsivas a la dirección y una lista de verificación para auditorías RTL. Este skill es esencial para evitar errores comunes de maquetación en aplicaciones multilingües y garantizar una experiencia de usuario coherente en ambos sentidos de escritura, ahorrando tiempo de depuración y asegurando la calidad del producto final.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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 LTRLógico (usar siempre)
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 (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-end para 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 con right-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-b está bien.
  • Tabla: el orden de las columnas se refleja automáticamente; alinea las celdas numéricas con text-end y 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-2 o flex gap-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 RTL
  • rotate-45 decorativo → generalmente bien
  • Deslizamiento de carrusel: embla/swiper — establece la opción direction: rtl o 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-x del 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-start ló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 de Select debe ser ChevronDown (sin dirección, sin cambios); InputOTP, CommandDialog y ResizablePanel necesitan 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.

Individual skills in this repo

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

Skills relacionados