En esta página

Interfaces de usuario de derecha a izquierda

Resumen

En este capítulo se analizan los diferentes enfoques y opciones disponibles para implementar la compatibilidad con idiomas que se escriben de derecha a izquierda en aplicaciones de Qt Quick. Algunos de los idiomas de escritura de derecha a izquierda más comunes son el árabe, el hebreo, el persa y el urdu. La mayoría de los cambios consisten en asegurarse de que el texto traducido a idiomas de escritura de derecha a izquierda quede correctamente alineado a la derecha, y de que el contenido ordenado horizontalmente en vistas, listas y cuadrículas fluya correctamente de derecha a izquierda.

En las culturas en las que se hablan idiomas de escritura de derecha a izquierda, las personas escanean y leen de forma natural los elementos gráficos y el texto de derecha a izquierda. La regla general es que el contenido (como fotos, vídeos y mapas) no se refleje, pero sí se refleje la disposición del contenido (como los diseños de la aplicación y el flujo de los elementos visuales). Por ejemplo, las fotos mostradas en orden cronológico deben fluir de derecha a izquierda, el extremo inferior de los controles deslizantes horizontales debe situarse en el lado derecho del control, y las líneas de texto deben alinearse al lado derecho del área de texto disponible. La ubicación de los elementos visuales no debe invertirse cuando dicha posición esté relacionada con un contenido; por ejemplo, cuando se muestra un marcador de posición para indicar una ubicación en un mapa. Además, hay algunos casos especiales que quizá debas tener en cuenta en los que los hablantes de idiomas de escritura de derecha a izquierda están acostumbrados al posicionamiento de izquierda a derecha, por ejemplo, al utilizar el teclado numérico de los teléfonos y los botones de reproducción, pausa, rebobinado y avance rápido en los reproductores de música.

Alineación del texto

(Esto se aplica a los tipos « Text », « TextInput » y « TextEdit ».)

Cuando no se establece explícitamente la alineación horizontal de un elemento de texto, este se alinea automáticamente según la dirección natural de lectura del texto. Por defecto, el texto de izquierda a derecha, como el inglés, se alinea a la izquierda del área de texto, y el texto de derecha a izquierda, como el árabe, se alinea a la derecha del área de texto. La alineación de un elemento de texto con contenido vacío se rige por la propiedad ` QInputMethod::inputDirection()`, que se basa en la configuración regional activa del sistema.

Esta alineación predeterminada basada en la configuración regional se puede anular estableciendo la propiedad horizontalAlignment del elemento de texto, o activando el reflejo de diseño mediante la propiedad adjunta LayoutMirroring, lo que hace que cualquier alineación horizontal explícita a la izquierda y a la derecha se refleje. Tenga en cuenta que, cuando se establece « LayoutMirroring », el valor de la propiedad « horizontalAlignment » permanece inalterado; la alineación efectiva del elemento de texto, que tiene en cuenta el reflejo, puede consultarse en la propiedad « effectiveHorizontalAlignment ».

// automatically aligned to the left
Text {
    text: "Phone"
    width: 200
}

// automatically aligned to the right
Text {
    text: "خامل"
    width: 200
}

// aligned to the left
Text {
    text: "خامل"
    horizontalAlignment: Text.AlignLeft
    width: 200
}

// aligned to the right
Text {
    text: "خامل"
    horizontalAlignment: Text.AlignLeft
    LayoutMirroring.enabled: true
    width: 200
}

Dirección de maquetación de los posicionadores y las vistas

(Esto se aplica a los tipos Row, Grid, Flow, ListView y GridView.)

Los tipos utilizados para el posicionamiento horizontal y las vistas de modelo disponen de la propiedad layoutDirection para controlar la dirección horizontal de la disposición. Al establecer layoutDirection en Qt.RightToLeft, los elementos se disponen de derecha a izquierda. De forma predeterminada, Qt Quick sigue la dirección de disposición de izquierda a derecha.

La dirección de disposición horizontal también se puede invertir mediante la propiedad adjunta LayoutMirroring. Esto hace que se refleje la layoutDirection efectiva de los posicionadores y las vistas. Tenga en cuenta que el valor real de la propiedad layoutDirection permanecerá sin cambios; la dirección de disposición efectiva de los posicionadores y las vistas, que tiene en cuenta el reflejo, se puede leer en la propiedad effectiveLayoutDirection.

// by default child items are positioned from left to right
Row {
    Child {}
    Child {}
}

// position child items from right to left
Row {
    layoutDirection: Qt.RightToLeft
    Child {}
    Child {}
}

// position child items from left to right
Row {
    LayoutMirroring.enabled: true
    layoutDirection: Qt.RightToLeft
    Child {}
    Child {}
}

Inversión de la disposición

La propiedad adjunta LayoutMirroring se proporciona para facilitar la implementación de la compatibilidad de la escritura de derecha a izquierda en aplicaciones existentes con Qt Quick de escritura de izquierda a derecha. Invertirá el comportamiento de los anclajes de elementos, la dirección de diseño de los posicionadores y las vistas de modelo, así como la alineación explícita del texto de los tipos de texto de QML.

Puedes habilitar el reflejo de diseño para un Item concreto:

Item {
    height: 50; width: 150

    LayoutMirroring.enabled: true
    anchors.left: parent.left   // anchor left becomes right

    Row {
        // items flow from left to right (as per default)
        Child {}
        Child {}
        Child {}
    }
}

O bien, configurar todos los tipos secundarios para que también hereden la dirección de diseño:

Item {
    height: 50; width: 150

    LayoutMirroring.enabled: true
    LayoutMirroring.childrenInherit: true
    anchors.left: parent.left   // anchor left becomes right

    Row {
        // setting childrenInherit in the parent causes these
        // items to flow from right to left instead
        Child {}
        Child {}
        Child {}
    }
}

Aplicar el reflejo de esta manera no modifica el valor real de las propiedades relevantes «anchor», « layoutDirection » o « horizontalAlignment ». La propiedad independiente de solo lectura « effectiveLayoutDirection » puede utilizarse para consultar la dirección de diseño efectiva de los posicionadores y las vistas de modelo, teniendo en cuenta el reflejo. Del mismo modo, los tipos « Text », « TextInput » y « TextEdit » cuentan ahora con la propiedad de solo lectura « effectiveHorizontalAlignment » para consultar la alineación visual efectiva del texto.

Tenga en cuenta que los diseños y animaciones de la aplicación que se definen utilizando valores de la propiedad « x » (a diferencia de los anclajes o los tipos de posicionador) no se ven afectados por la propiedad adjunta « LayoutMirroring ». Por lo tanto, añadir compatibilidad con la escritura de derecha a izquierda a este tipo de diseños puede requerir algunos cambios en el código de su aplicación, especialmente en vistas que dependen tanto de los anclajes como del posicionamiento basado en coordenadas x. A continuación se muestra una forma de utilizar la propiedad asociada « LayoutMirroring » para aplicar el reflejo a un elemento cuyo posicionamiento se basa en coordenadas « x »:

Rectangle {
    color: "black"
    height: 50; width: 50
    x: mirror(10)
    function mirror(value) {
        return LayoutMirroring.enabled ? (parent.width - width - value) : value;
    }
}

No todos los diseños deben reflejarse necesariamente. Hay casos en los que un tipo visual se coloca en el lado derecho de la pantalla para facilitar su uso con una sola mano, ya que la mayoría de las personas son diestras, y no por la dirección de lectura. En caso de que un tipo secundario no deba verse afectado por el reflejo, establece la propiedad « LayoutMirroring.enabled » de ese tipo en «false».

Qt Quick está diseñado para desarrollar interfaces de usuario animadas y fluidas. Al reflejar tu aplicación, recuerda comprobar que las animaciones y transiciones sigan funcionando según lo esperado. Si no dispones de los recursos necesarios para añadir compatibilidad con la escritura de derecha a izquierda a tu aplicación, quizá sea mejor mantener los diseños de la aplicación alineados a la izquierda y asegurarte simplemente de que el texto esté traducido y alineado correctamente.

Duplicación de iconos

(Esto se aplica a los tipos Image, BorderImage y AnimatedImage.)

La mayoría de las imágenes no necesitan invertirse, pero puede que sea necesario invertir algunos iconos direccionales, como las flechas. La representación de estos iconos se puede invertir mediante una propiedad específica de mirror:

Image {
    source: "arrow.png"
    mirror: true
}

Dirección de diseño predeterminada

Utilice la propiedad Qt.application.layoutDirection para consultar la dirección de diseño activa de la aplicación. Hereda de QGuiApplication::layoutDirection(), que determina la dirección de diseño a partir del archivo de traducción del idioma activo.

Para definir la dirección de diseño para una configuración regional concreta, declara el literal de cadena específico QT_LAYOUT_DIRECTION en el contexto QGuiApplication como LTR o RTL.

En primer lugar, introduce esta línea en algún lugar de tu código fuente QML:

qsTr("QT_LAYOUT_DIRECTION","QGuiApplication");

A continuación, utiliza lupdate para generar el archivo fuente de traducción.

Esto añade la siguiente declaración al archivo de traducción, donde puede introducir « LTR » o « RTL » como traducción para la configuración regional.

<context>
    <name>QGuiApplication</name>
    <message>
        <location filename="myapp.qml" line="33"/>
        <source>QT_LAYOUT_DIRECTION</source>
        <translation type="unfinished">RTL</translation>
    </message>
</context>

A continuación, añade los siguientes enlaces al componente QML raíz de tu aplicación:

LayoutMirroring.enabled: Qt.application.layoutDirection === Qt.RightToLeft
LayoutMirroring.childrenInherit: true

El primer enlace garantiza que la interfaz de usuario se refleje correctamente cuando se establezca una configuración regional de escritura de derecha a izquierda. El segundo enlace garantiza que los elementos hijos del componente raíz también respeten el reflejo.

Puedes comprobar que la dirección de diseño funciona según lo esperado ejecutando tu aplicación « Qt Quick » con el archivo de traducción compilado:

qml myapp.qml -translation myapp.qm

Puedes probar tu aplicación con la dirección de diseño de derecha a izquierda llamando a la función estática QGuiApplication::setLayoutDirection():

QGuiApplication app(argc, argv);
app.setLayoutDirection(Qt::RightToLeft);

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.