Accessibility guidelines are included throughout the HIG and, the pages on keyboard interaction, pointer interaction, and UI styling are especially relevant to this topic.

General Guidelines#

Good design and accessibility are mutually reinforcing, and many of the principles of good design advocated by these guidelines enhance accessibility. Thinking carefully about how to follow those principles is one of the best ways to improve the accessibility of your app.

Accessible Names#

All interface elements should have descriptive, accessible names. These provide the text that is read aloud by screen readers.

GTK provides default accessible descriptions for many UI elements, but they may need to be added in some cases. Consider overriding the defaults with more helpful or app-specific descriptions where possible.

Accessible names should be short and descriptive.

Testing for Accessibility#

There are a number of quick and easy ways to check whether your app is accessible, and these are described in the relevant pages of the HIG. The following list brings these tests together for convenience.

In each case, test to ensure that your app works correctly with accessibility features, including:

  • High-contrast mode. This can be enabled from GTK Inspector or globally in the Accessibility settings. All parts of the UI should be correctly rendered in the high-contrast style.

  • Large text mode. This can be enabled in the Accessibility settings. Does the UI look correct with it enabled? Can all labels be read?

  • Keyboard navigation. Use the app using only the keyboard. Can every part of the app be navigated to and interacted with? Does the UI follow the keyboard navigation guidelines?

  • Screen reader. This can be enabled from the Accessibility settings. Is each UI element read aloud? Are the accessible names accurate? Can you turn the display off and still use the app?

  • On-screen keyboard: can your app be used while relying on the OSK for text input? Can every text entry be successfully used with it?