A Scrollbar ARIA Role is missing required aria attributes
| Field | Value |
|---|---|
| Rule code | Scrollbar_AttributeRequirement_Missing |
| WCAG conformance level | A |
| WCAG success criterion | 4.1.2 Name, Role, Value |
| Must be fixed at source | No |
Description
The Scrollbar ARIA role requires 'aria-controls', 'aria-orientation', 'aria-valuemin', 'aria-valuemax', and 'aria-valuenow' for full accessibility. Without these required attributes, screen readers and other assistive tools cannot properly announce or interpret the scrollbar's state or the content it controls, making their usability difficult. Missing or misconfigured attributes can lead to inaccurate default values, reducing accessibility. If the 'aria-controls' attribute is present but all others are missing, they will default to the following: 'aria-valuemin' defaults to 0, 'aria-valuemax' defaults to 100, and 'aria-valuenow' defaults to halfway between 'aria-valuemin' and 'aria-valuemax'. If 'aria-valuenow' is less than 'aria-valuemin', it defaults to 'aria-valuemin', and if greater than 'aria-valuemax', it defaults to 'aria-valuemax'. The default 'aria-orientation' is vertical. More details: https://www.w3.org/TR/wai-aria-1.1/#scrollbar.
How to fix
Ensure each element with role='scrollbar' has 'aria-controls', 'aria-orientation', 'aria-valuemin', 'aria-valuemax', and 'aria-valuenow' attributes (e.g., <div role='scrollbar' aria-controls='content' aria-orientation='vertical' aria-valuemin='0' aria-valuemax='100' aria-valuenow='50'></div>).