En esta página

Accesibilidad para aplicaciones « Qt Quick »

Introducción

Esta página explica cómo añadir metadatos de accesibilidad a las aplicaciones de Qt Quick. Las aplicaciones de Qt Quick y muchos de sus tipos QML ya cuentan con funciones de accesibilidad integradas. Por ejemplo, los controles de botón disponen de accesibilidad mediante teclado, lo que permite desplazarse entre los controles con la tecla Tab y activarlos utilizando las teclas Retorno o Intro. Por lo tanto, al utilizar los controles existentes, ya tienes un buen punto de partida para hacer que tu aplicación Qt Quick sea accesible. Sin embargo, en algunos casos, puede que tengas que aclarar la función de un elemento QML.

Al igual que al hacer accesibles las aplicaciones web, se asignan propiedades a los elementos de la interfaz de usuario; en este caso, a los elementos QML. Estas propiedades exponen metadatos a las herramientas de accesibilidad, lo que, junto con temas de colores de alto contraste cuidadosamente elegidos y otras señales visuales, ayuda al usuario a interactuar con tu aplicación Qt Quick.

En general, las herramientas de accesibilidad se centran en tres categorías diferentes de metadatos:

  • Propiedades: el cliente de accesibilidad lee los metadatos sobre los objetos accesibles. En algunos casos, el cliente de accesibilidad también puede modificar estas propiedades, como el texto de un campo de edición de línea.
  • Acciones: el cliente de accesibilidad invoca acciones, como pulsar un botón.
  • Relaciones y navegación: el cliente de accesibilidad se desplaza de un objeto accesible a otro utilizando las relaciones entre los objetos.

En el caso de las aplicaciones « Qt Quick », el tipo más importante que hay que tener en cuenta es el tipo QML « Accessible », que añade metadatos de accesibilidad a los elementos QML.

Añadir metadatos de accesibilidad a elementos QML

Para añadir metadatos de accesibilidad a elementos QML, ya sean tipos existentes proporcionados por Qt o tipos personalizados definidos en C++, utilice el tipo QML ` Accessible `. Las propiedades más importantes del tipo QML ` Accessible ` son ` name`, ` description` y ` role`.

A continuación se muestra un ejemplo de cómo añadir metadatos de accesibilidad a un tipo ` Text `, que, en este caso, representa una ecuación matemática:

Text {
    id: myMathEquation
    text: "y = 8x - 9"
    font.family: "Helvetica"

    Accessible.role: Accessible.Equation
    Accessible.name: myMathEquation.text
    Accessible.description: qsTr("Linear equation")
    Accessible.onPressAction: {
        // Highlight the x variable
        ...
    }
}

El role se establece en Equation para indicar lo que representa el tipo Text. name es la propiedad más importante, que está vinculada al texto del botón. Para proporcionar información adicional sobre un elemento QML, utilice la propiedad description. El controlador de señal Accessible.pressAction, que puede ser invocado por herramientas de accesibilidad para activar el botón, debe tener el mismo efecto que pulsar o hacer clic en el texto.

Mientras que el contenido textual es accesible por naturaleza, el contenido multimedia no lo es. Por eso es importante proporcionar los metadatos de accesibilidad necesarios al contenido multimedia, como imágenes, vídeos y audio. A continuación se muestra un ejemplo de cómo proporcionar metadatos de accesibilidad a una imagen que representa un gráfico circular:

Image {
    source: "pie-chart-683.png"
    Accessible.role: Accessible.Chart
    Accessible.name: qsTr("Pie chart")
    Accessible.description: qsTr("Pie chart that shows the distribution
    of sales from three store locations: Durban representing 60 percent,
    Johannesburg 20 percent, and Cape Town 20 percent")
    Accessible.onPressAction: {
        // Expand the image
        ...
    }
}

Para obtener más información, consulta Accessible, donde encontrarás la lista de propiedades que puedes añadir a los elementos QML.

© 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.