Skip to main content
Version: v6

A combobox element is missing required aria attributes

A combobox element is missing required aria attributes — rule summary
FieldValue
Rule codeCombobox_AttributeRequirement_Missing
WCAG conformance levelA
WCAG success criterion4.1.2 Name, Role, Value
Must be fixed at sourceNo

Description

Comboboxes must include specific ARIA attributes to be fully accessible to assistive technologies. These elements should have 'aria-controls' to reference the associated dropdown list, and 'aria-expanded' to indicate whether the dropdown is currently open or closed. Missing any of these attributes can lead to incomplete or incorrect interpretation of the combobox's state by screen readers. Ensure all required ARIA attributes are present for combobox elements. More details on ARIA role requirements are available here: https://www.w3.org/TR/wai-aria-1.1/#combobox.

How to fix

To resolve this issue, ensure that each combobox element has both 'aria-controls' and 'aria-expanded' attributes. The 'aria-controls' attribute should reference the ID of the associated dropdown list, and the 'aria-expanded' attribute should indicate the current state of the dropdown (true for open, false for closed). This will ensure proper functionality and accessibility for screen readers.