Edit

Share via

Accessibility checklist

  • Article

Provides a checklist to help you ensure that your Windows app is accessible .

Here we provide a checklist you can use to ensure that your app is accessible.

  1. Set the accessible name (required) and description (optional) for content and interactive UI elements in your app.

    An accessible name is a short, descriptive text string that a screen reader uses to announce a UI element. Some UI elements such as TextBlock and TextBox promote their text content as the default accessible name; see Basic accessibility information.

    You should set the accessible name explicitly for images or other controls that do not promote inner text content as an implicit accessible name. You should use labels for form elements so that the label text can be used as a LabeledBy target in the Microsoft UI Automation model for correlating labels and inputs. If you want to provide more UI guidance for users than is typically included in the accessible name, accessible descriptions and tooltips help users understand the UI.

    For more info, see Accessible name and Accessible description.

  2. Implement keyboard accessibility:

    • Test the default tab index order for a UI. Adjust the tab index order if necessary, which may require enabling or disabling certain controls, or changing the default values of TabIndex on some of the UI elements.
    • Use controls that support arrow-key navigation for composite elements. For default controls, the arrow-key navigation is typically already implemented.
    • Use controls that support keyboard activation. For default controls, particularly those that support the UI Automation Invoke pattern, keyboard activation is typically available; check the documentation for that control.
    • Set access keys or implement accelerator keys for specific parts of the UI that support interaction.
    • For any custom controls that you use in your UI, verify that you have implemented these controls with correct AutomationPeer support for activation, and defined overrides for key handling as needed to support activation, traversal and access or accelerator keys.

    For more info, see Keyboard interactions.

  3. Ensure text is a readable size

    • Windows includes various accessibility tools and settings that users can take advantage of and adjust to their own needs and preferences for reading text. These include:
      • The Magnifier tool, which enlarges a selected area of the UI. You should ensure the layout of text in your app doesn't make it difficult to use Magnifier for reading.
      • Global scale and resolution settings in Settings->System->Display->Scale and layout. Exactly which sizing options are available can vary as this depends on the capabilities of the display device.
      • Text size settings in Settings->Ease of access->Display. Adjust the Make text bigger setting to specify only the size of text in supporting controls across all applications and screens (all UWP text controls support the text scaling experience without any customization or templating).

      Note

      The Make everything bigger setting lets a user specify their preferred size for text and apps in general on their primary screen only.

  4. Visually verify your UI to ensure that the text contrast is adequate, elements render correctly in the high-contrast themes, and colors are used correctly.

    • Use a color analyzer tool to verify that the visual text contrast ratio is at least 4.5:1.
    • Switch to a high contrast theme and verify that the UI for your app is readable and usable.
    • Ensure that your UI doesn’t use color as the only way to convey information.

    For more info, see High-contrast themes and Accessible text requirements.

  5. Run accessibility tools, address reported issues, and verify the screen reading experience.

    Use tools such as Inspect to verify programmatic access, run diagnostic tools such as AccChecker to discover common errors, and verify the screen reading experience with Narrator.

    For more info, see Accessibility testing.

  6. Make sure your app manifest settings follow accessibility guidelines.

  7. Declare your app as accessible in the Microsoft Store.

    If you implemented the baseline accessibility support, declaring your app as accessible in the Microsoft Store can help reach more customers and get some additional good ratings.

    For more info, see Accessibility in the Store.