aria-controls - Accessibility | MDN (2024)

FAQs

What are the valid values for aria-controls? ›

The only accepted values for the aria-current property are page, step, location, date, time, true and false. A non-null aria-current state on an element indicates that this element represents the current item within a container or set of related elements.

ARIA roles provide semantic meaning to content, allowing screen readers and other tools to present and support interaction with an object in a way that is consistent with user expectations of that type of object.

aria-controls

It identifies the element(s) that are controlled by the current element. The "aria-controls" element should be a "button" or a "link".

Accessible Rich Internet Applications ( ARIA ) is a set of roles and attributes that define ways to make web content and web applications (especially those developed with JavaScript) more accessible to people with disabilities.

How to Fix the Problem. Ensure the value inside each attribute is spelled correctly and corresponds to a valid value. For example, aria-hidden="true" would pass, but aria-hidden="rtue" would fail, as would aria-hidden="pizza" .

The aria-controls only needs to be set when the popup is visible, but it is valid and easier to program to reference an element that is not visible.

What constitutes a broken ARIA reference? If Accessibility Checker flags a broken ARIA reference on your WordPress site, that means that an aria-labeledby or aria-describedby element is present on the page or post but that its reference target does not exist.

Accessibility is the responsibility of everyone involved in the project, including but not limited to the owner, designers, architects, engineers, builders, and contractors. Best practices to ensure compliance include identifying accessibility compliance as a key goal at the onset of a project.

What is the difference between aria-owns and controls? ›

Answer. The aria-controls property and the aria-owns property are both used when the relationship between elements cannot be determined from the DOM, but they each communicate a different type relationship. aria-controls identifies the element(s) whose contents are controlled by the current element.

The difference between -owns and -controls is that -owns creates a parent/child relationship where none exists, and -controls indicates that one thing controls the other. So A can control B, but A doesn't have to be a parent of B for that to be the case.

Adding aria-hidden="true" to an HTML element removes that element and all elements nested within it so that it is not visible or announced to users of assistive technology such as screen readers.

The Rules of ARIA

First Rule of ARIA: Don't use ARIA. Well, actually, it says "if you can use a native HTML element or attribute... then do so." So, if you need a textbox, use an input, if you need a dropdown, use a select, if you need a button, use a button.

It is an accessibility attribute that tells screen readers and other assistive technologies to ignore or hide the element from the user. When an element has aria-hidden="true" , it will not be presented to screen reader users.

Description. The aria-invalid attribute is used to indicate that the value entered into an input field is not in a format or a value the application will accept. This may include formats such as email addresses or telephone numbers.

The aria-pressed attribute is only relevant for toggle buttons. It represents the button's current "pressed" state. The value is "tri-state", meaning the value can be set to true , false , mixed , or undefined values. In the case of aria-pressed , like most tri-state value types, the default value is undefined .

aria-valuetext provides a way of presenting the current value in a more user-friendly, human-understandable way. For example, a battery meter value might be conveyed as aria-valuetext="8% (34 minutes) remaining" .

ARIA is shorthand for Accessible Rich Internet Applications. ARIA is a set of attributes you can add to HTML elements that define ways to make web content and applications accessible to users with disabilities who use assistive technologies (AT).