# RTL y localización de la UI: qué reflejar y qué dejar igual

> Los idiomas de derecha a izquierda, como el árabe o el hebreo, exigen reflejar parte de la interfaz y mantener el resto. Qué invertir, qué no y cómo probarlo.

*Tags: ux, tecnica, localizacion, rtl, interfaz*

---


> [!info] Definición Rápida
> La **localización de la UI en RTL** (de derecha a izquierda) es adaptar la interfaz a idiomas como el árabe o el hebreo. Exige reflejar los elementos que indican dirección o movimiento, mantener los que no la tienen y revisar que el texto, los números y el contenido de origen LTR se muestren de forma correcta.


## ¿Qué significa RTL?

Son las siglas de *right-to-left*, la dirección de lectura de idiomas como el árabe, el hebreo o el persa. En una interfaz RTL, el inicio de la línea está a la derecha, y el orden de los elementos en una fila también se invierte.

Un error común es pensar que RTL es solo "espejar" la pantalla. No es así: el texto y los números no se invierten, y muchos elementos deben quedar igual. La clave está en distinguir qué tiene dirección y qué no.

## ¿Por qué le importa a un diseñador?

Porque una interfaz que se refleja a ciegas se ve mal. Las guías de Apple advierten que reflejar una fotografía o una ilustración suele cambiar su significado, y que un logo se muestra siempre en su forma original. Entender qué reflejar es parte del diseño, no solo del desarrollo.

Apple ofrece símbolos ya localizados y permite definir la direccionalidad de los símbolos personalizados para idiomas como el árabe y el hebreo. Eso confirma que la decisión es de diseño: cada símbolo tiene una dirección o no la tiene.

## ¿Qué reflejar?

Mozilla, Apple y Very Good Ventures coinciden en reflejar lo que muestra dirección, movimiento, progreso o secuencia:

| Elemento | ¿Se refleja? | Fuente |
|---|---|---|
| Botones de atrás y adelante | Sí: el de atrás apunta a la derecha | Mozilla, Apple |
| Controles que muestran progreso de un valor a otro | Sí | Mozilla, Apple |
| Iconos que representan texto o dirección de lectura | Sí | Apple |
| Elementos que muestran tiempo o secuencia | Sí: el tiempo se muestra de derecha a izquierda | Mozilla |
| Orden de imágenes cuando el orden tiene significado | Sí | Apple |

Hay un caso sin regla universal. Very Good Ventures indica que los indicadores de progreso de reproducción de medios se mantienen en LTR, porque modelan una cinta que se reproduce, mientras que Mozilla y Apple reflejan los controles de progreso en general. Define una regla propia para tu proyecto y aplícala siempre.

### ¿Qué no reflejar?

- **Texto y números.** Mozilla no invierte el orden de números ni de unidades: "1920x1080" no pasa a "1080x1920" y "10 px" no pasa a "px 10".
- **Números concretos.** Apple pide no invertir los dígitos de un número específico, como 541, un teléfono o una tarjeta. Solo se invierte una secuencia que comunica progreso o un orden.
- **Relojes y objetos del mundo real.** Apple señala que los relojes funcionan igual en todas partes, así que un icono de reloj se ve igual en cualquier dirección.
- **Controles de reproducción de audio y video**, según Mozilla.
- **Fotografías e ilustraciones.** Reflejarlas suele cambiar su significado.
- **Logos y marcas universales**, que se muestran siempre en su forma original, aunque incluyan texto.
- **Iconos sin dirección**, como las marcas de verificación, según Mozilla.
- **Iconos con texto**, que conviene localizar en lugar de reflejar.

Para un icono personalizado complejo, Apple recomienda revisar sus componentes y el equilibrio visual antes de limitarse a reflejarlo.

## ¿Cómo se implementa sin romper nada?

En CSS, Mozilla recomienda usar propiedades lógicas en lugar de `left` y `right`: por ejemplo, `margin-inline-start` en vez de `margin-left`. Así el margen se adapta solo al cambiar la dirección. Si no existe un equivalente, usa una regla `:dir(rtl)` para ese caso concreto.

Para imágenes, Mozilla propone reflejarlas con `transform: scaleX(-1)`, pero advierte que no funciona cuando la imagen es un `background-image` de un elemento con texto. En ese caso, conviene tener un recurso ya reflejado y cargarlo en la regla RTL.

En Flutter, Very Good Ventures sugiere usar los equivalentes direccionales, como `EdgeInsetsDirectional`, que mantiene el relleno al inicio del texto sin importar su orientación. Muchos iconos de Flutter se reflejan por defecto al cambiar la dirección, y se puede fijar la dirección de uno concreto.

En HTML, el W3C pide declarar la dirección con el atributo `dir` en la etiqueta `html` (por ejemplo, `dir="rtl"`) y no con CSS. Ese ajuste también define la alineación predeterminada de los párrafos. Para texto de dirección mixta, como un campo donde cada línea puede estar en un idioma distinto, `dir="auto"` decide por la primera letra con dirección fuerte, aunque ese método no es perfecto.

Por último, Apple pide alinear los párrafos según su idioma y no según el contexto actual, y mantener una alineación consistente en todos los elementos de una lista.

## ¿Cómo se prueba?

Antes de traducir, prueba con pseudolocalización bidireccional. En Firefox se activa poniendo `intl.l10n.pseudo` en `bidi`, y la interfaz se voltea de inmediato. Mozilla avisa de que esta prueba puede mostrar rarezas de orden de texto que una versión real en RTL no tendría.

Apple propone planes de prueba en Xcode que ayudan a detectar texto cortado, truncado, superposiciones y problemas de formato RTL en los dispositivos e idiomas que soportas.

Después, prueba con hablantes del idioma. Un texto puede estar técnicamente bien reflejado y aun así sonar extraño o ser ambiguo.

## ¿Cuándo NO conviene una adaptación completa?

Si el producto no tiene planes de llegar a mercados RTL, no vale la pena invertir en una adaptación completa. Mejor deja preparada la base técnica, con propiedades lógicas y textos separados, y decide después.

Y si el idioma RTL es secundario y poco usado en tu producto, un espejo completo puede ser menos útil que una versión cuidada de las pantallas más importantes.

## Ejemplo

Ejemplo ilustrativo: una app de transporte quiere lanzar su pantalla de viaje en árabe. El equipo hace una lista de cada elemento y decide caso por caso. Refleja el orden de los pasos y el icono de atrás, y la barra de progreso del viaje avanza de derecha a izquierda. Mantiene sin cambios el icono de reloj, el logo y la placa del vehículo, porque son un objeto, una marca y un dato. El precio y el teléfono del conductor conservan el orden de sus dígitos. Antes de traducir, activan la pseudolocalización bidireccional y revisan cada pantalla en busca de texto cortado o superpuesto.

## Errores comunes

- **Reflejar todo** sin distinguir qué tiene dirección.
- **Invertir números, unidades o teléfonos**, que confunden.
- **Reflejar relojes, fotografías o logos** sin pensar en lo que representan.
- **Usar propiedades fijas** (`left`, `right`) en lugar de lógicas.
- **Probar solo en inglés** y descubrir los problemas al lanzar.
- **Dejar la decisión de reflejar a desarrollo** sin una guía de diseño.

Para la base técnica que hace posible esta adaptación, la [internacionalización](/es/wiki/conceptos/internacionalizacion/) explica cómo preparar el producto. Y para decidir qué mercados priorizar y qué adaptar en cada uno, la [estrategia de localización](/es/wiki/estrategia/estrategia-de-localizacion/) ofrece el marco general. Si el producto también debe ser legible para personas con dificultades de lectura, la [accesibilidad cognitiva](/es/wiki/conceptos/accesibilidad-cognitiva/) complementa estas decisiones.

## Fuentes

- [RTL Guidelines, Firefox Source Docs (Mozilla)](https://firefox-source-docs.mozilla.org/code-quality/coding-style/rtl_guidelines.html)
- [Right to left, Human Interface Guidelines, Apple Developer](https://developer.apple.com/design/human-interface-guidelines/right-to-left)
- [Localization, Apple Developer](https://developer.apple.com/localization/)
- [Text Directionality, Very Good Ventures](https://engineering.verygood.ventures/development/internationalization/text_directionality.md)
- [Declaring the base direction in HTML (dir), W3C Internationalization](https://www.w3.org/International/questions/qa-html-dir)


---

Source: https://www.fernandoux.com/es/wiki/tecnicas/rtl-y-localizacion-de-ui/
