Accessibilité des applications Qt Quick

Introduction

Cette page explique comment ajouter des métadonnées d'accessibilité aux applications Qt Quick. Les applications Qt Quick et un grand nombre de ses types QML possèdent déjà des fonctions d'accessibilité intégrées. Par exemple, les contrôles de bouton sont accessibles au clavier, ce qui permet de passer d'un contrôle à l'autre et de les activer à l'aide de la touche Retour ou Entrée. Ainsi, en utilisant les contrôles existants, vous avez déjà pris un bon départ pour rendre votre application Qt Quick accessible. Dans certains cas, cependant, il peut être nécessaire de clarifier la fonction d'un élément QML.

Comme pour rendre les applications web accessibles, vous attribuez des propriétés aux éléments de l'interface utilisateur, dans ce cas, aux éléments QML. Ces propriétés exposent des métadonnées aux outils d'accessibilité qui, associées à des thèmes de couleurs très contrastées et à d'autres indices visuels soigneusement choisis, aident l'utilisateur à interagir avec votre application Qt Quick.

En général, les outils d'accessibilité s'intéressent à trois catégories différentes de métadonnées :

• Propriétés: Le client d'accessibilité lit les métadonnées relatives aux objets accessibles. Dans certains cas, le client d'accessibilité peut également modifier ces propriétés, comme le texte dans une ligne d'édition.
• Actions: Le client d'accessibilité invoque des actions, comme appuyer sur un bouton.
• Relations et navigation: Le client d'accessibilité passe d'un objet accessible à un autre en utilisant les relations entre les objets.

Pour les applications Qt Quick, le type le plus important à connaître est le type QML Accessible, qui ajoute des métadonnées d'accessibilité aux éléments QML.

Ajout de métadonnées d'accessibilité aux éléments QML

Pour ajouter des métadonnées d'accessibilité aux éléments QML, soit aux types existants fournis par Qt, soit aux types personnalisés définis en C++, utilisez le type QML Accessible. Les propriétés les plus importantes du type QML Accessible sont name, description et role.

Voici un exemple d'ajout de métadonnées d'accessibilité à un type Text qui, dans ce cas, représente une équation mathématique :

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

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

La propriété role est définie sur Equation pour indiquer ce que représente le type Text. name est la propriété la plus importante, qui est liée au texte du bouton. Pour fournir des informations supplémentaires sur un élément QML, utilisez la propriété description. Le gestionnaire de signal Accessible.pressAction, qui peut être invoqué par les outils d'accessibilité pour déclencher le bouton, doit avoir le même effet que le fait d'appuyer ou de cliquer sur le texte.

Alors que le contenu textuel est intrinsèquement accessible, le contenu multimédia ne l'est pas. Il est donc important de fournir les métadonnées d'accessibilité nécessaires aux contenus multimédias tels que les images, les vidéos et les fichiers audio. Voici un exemple de métadonnées d'accessibilité pour une image représentant un diagramme circulaire :

Image {
    source: "pie-chart-683.png"
    Accessibility.role: Accessible.Chart
    Accessibility.name: qsTr("Pie chart")
    Accessibility.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
        ...
    }
}

Pour plus d'informations, voir Accessible pour la liste des propriétés que vous pouvez ajouter aux éléments QML.

Classes et interfaces connexes

• QAccessible
• QAccessibleInterface