In this Article
Why it Matters
Some ARIA roles known as widgets require additional attributes to describe the widget's state. If the required attribute is not included, a screen reader will not be able to communicate the current state or properties of the widget to the user.
For example, the role checkbox must have the attribute of aria-checked so the accessible technology can inform the user of the 'state' of the checkbox, true, false, or mixed.
Diagnosing a Problem from a Page View
Follow these steps to begin your diagnosis:
From the Detail Page View in DubBot, expand the details for the Issue you are investigating
In the Element Source section, find the role and value (
role="heading"in the example below) that has been flagged.In the Failure Summary section, you will see the missing ARIA attribute in the Element Source section.
If you are not given the missing ARIA attribute, you can refer to our Required ARIA Attributes Quick Reference or to the WAI-ARIA specification itself.
Related Articles
Learn More
Using WAI-ARIA from W3C
WAI-ARIA Roles from mdn docs
Understanding Information and Relationships (A) from WCAG
ARIA Authoring Practices Guide - good examples of some of the more common patterns (expandables, carousels, etc)
DubBot Flags:
Required ARIA attributes must be provided
Ensures elements with ARIA roles have all required ARIA attributes
If you have questions, please contact our DubBot Support team via email at help@dubbot.com or via the blue chat bubble in the lower right corner of your screen. We are here to help!