ACT-R2: Proper use of aria-describedby
Important Information for reviewing ACT Rules
Important: The ACT Rules on this page are a demonstration of how they might be published by the W3C. The goal of this page is to add concrete examples for the Accessibility Conformance Testing Rules Format (DRAFT). Neither the ACT Rules, or the way they are presented here has been approved by the Accessibility Guidelines Working Group. If you have feedback, please comment by filing GitHub issues in the WCAG ACT repository, if this is not feasible, by email to email@example.com.
This conformance rule relates to:
- Success Criterion 1.1.1 (Non-text Content)
This rule checks the sufficient provision of a long text description for images that are using the
Elements are not checked for references to long text descriptions within short text alternatives such as “The image is described in text below”.
This rule maps to WCAG 2.0 success criterion 1.1.1 and checks the following techniques and failures:
- ARIA15: Using aria-describedby to provide descriptions of images
- G73: Providing a long description in another location with a link to it that is immediately adjacent to the non-text content
- G74: Providing a long description in text near the non-text content, with a reference to the location of the long description in the short description
- G92: Providing long description for non-text content that serves the same purpose and presents the same information
- F67: Failure of Success Criterion 1.1.1 and 1.2.1 due to providing long descriptions for non-text content that does not serve the same purpose or does not present the same information
- The proper provision of a short text alternative is checked in SC1-1-1-text-alternative.
- If the
aria-describedbyattribute is provided, a long description was intended and is needed for the element.
- This test assumes that
role="img"is used exclusively on elements that represent graphical content.
Aspects Under Test
For each target element, at least one of the identifiers in the
aria-describedby attribute is a valid identifier.
For each target element that fulfills Expectation 1, at least one of the elements referenced by the
aria-describedby attribute exists.
This rule is an example, precise definitions will be added before publication.
Changes since the previous version
- Rule is updated to applicability / expectations format
This ACT rule was created by Frank Berker and Kasper Isager.
To validate the implementation of this rule, all test cases for ACT-R2 must be passed.