This page explains how to add accessibility metadata to Qt Quick applications. Qt Quick applications and many of its QML types already have built-in accessibility features. For example, the 按钮控件 have keyboard accessibility, which makes it possible to tab between the controls and activate them using the Return or Enter key. So, by using existing controls, you are already off to a good start in making your Qt Quick application accessible. In some cases, however, you may need to clarify the job of a QML item.
Similar to making web applications accessible , you assign properties to UI elements, in this case, to QML items. These properties expose metadata to accessibility tools, which, together with carefully chosen high-contrast color themes and other visual cues, aid the user in interacting with your Qt Quick application.
In general, accessibility tools are interested in three different categories of metadata:
For Qt Quick applications, the most important type to be aware of is the Accessible QML type, which adds accessibility metadata to QML items.
To add accessibility metadata to QML items, either to existing types provided by Qt or to custom types defined in C++, use the Accessible QML type. The most important properties of the Accessible QML type are name , description ，和 role .
Here's an example of adding accessibility metadata to a
文本
type, which, in this case, represents a mathematical equation:
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
...
}
}
The
role
被设为
Equation
to indicate what the
文本
type represents.
name
is the most important property, which is bound to the text of the button. To provide extra information about a QML item, use the
description
property. The signal handler
Accessible.pressAction
, which can be invoked by accessibility tools to trigger the button, needs to have the same effect as tapping or clicking the text.
Whereas textual content is inherently accessible, multimedia content is not. So it's important to provide necessary accessibility metadata to multimedia content such as images, videos, and audio. Here's an example of providing accessibility metadata to an image, which represents a pie chart:
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
...
}
}
更多信息，见 Accessible for the list of properties you can add to QML items.