Web Governance
ARIA refers to a non-existing ID
1.3.1 Info and Relationships
This document provides information about the Acquia Web Governance accessibility check:
ARIA refers to a non-existing ID.
When the aria-controls attribute is used on an expanded combobox or a scrollbar, the value of the aria-controls attribute must include the ID of at least one element in the same shadow tree or document.
If an aria-controls attribute value does not point to a valid ID, the intended accessibility function may not work as expected. This can impact users who need assistive technologies that rely on correct ARIA to communicate the content and functionality of the page.
This check affects the following users who have:
Visual impairments: Who access the site contents with a screen reader or screen magnification software.
Mobility impairments: Who navigate the page with speech recognition software.
Bridgit is a blind mother to a five-year-old girl and an 11-year-old boy:
"There are some things that are just tricky, and then there are things that do not work at all. One thing that often does not work is those dropdowns where you have to search for something. You know, where you type in text and then a list of suggestions pops up, and you have to choose from that list instead of just typing what you want.
This happens a lot when I am booking flights. The field where I have to choose which airport I am flying from and to. Sometimes I can type in the text, and the screen reader will tell me there are, say, 3 or 10 results on the list. But I cannot see or select anything from that list. I just get stuck and cannot move forward."
This section gives some examples of the issue.
The value of the aria-controls attribute for this expanded combobox matches the ID of the <ul> element in the same document, which is good.
Web Governance<label for="fly_from_combo">From</label>
<input type="text" id="fly_from_combo"
role="combobox"
aria-expanded="true"
aria-controls="popup_listbox"
aria-activedescendant="selected_option"
</input>
<ul role="listbox" id="popup_listbox">
<li role="option" id="selected_option">Copenhagen - Kastrup (CPH)</li>
<li role="option">Wroclaw - Copernicus (WRO)</li>
</ul>
Because the aria-controls attribute correctly refers to the list ID, assistive technologies can establish the correct link between the combobox text input and the dropdown list of suggestions. When there is no valid reference from the aria-controls attribute, users of assistive technologies, like screen readers, might not be able to read the options in the list.
This section provides instructions on how to identify and fix the issue.
The Acquia Web Governance platform flags instances of aria-controls attributes that do not reference a valid ID on the page.
For any instance where the aria-controls attributes do not refer to a valid ID, make a correction to the code to ensure that the value in the aria-controls attribute points to a valid, existing ID on the page.
For more information, refer to the ACT Rules section below, which includes a link to a complete technical explanation of this check.
Related accessibility conformance testing rules:
ARIA required ID references exist
If this content did not answer your questions, try searching or contacting our support team for further assistance.
If this content did not answer your questions, try searching or contacting our support team for further assistance.