Affects Version/s: 3.0.15
Fix Version/s: 3.0.17
Sprint:UI - 2022-11
Related to WCAG 2.1 level AA criteria 4.1.3: status messages
Status message is not automatically announced by the screen reader.
- "xx results"
- "Search results" section
On entering text in the "Full Search" input field in the "Search Filters" section, the results get updated. However, the same information is not announced automatically to the screen reader users.
Recommendation to fix
Status messages MUST be programmatically determined through role or properties such that they can be presented to the user by assistive technologies without receiving focus.
HOW TO FIX:
Fix this issue by using an ARIA live region so screen readers can automatically announce the status message content.
<div aria-live="assertive">Your form was successfully submitted</div>
<div role="alert">Please correct the errors below to continue</div>
WCAG Understanding document: https://www.w3.org/WAI/WCAG21/Understanding/status-messages
When a status message is added to a webpage, screen reader users will likely not know about the message if focus is not moved to the message. Often it is not desirable to interrupt a user's workflow to move focus to a status message, so people who are blind must be alerted programmatically to the presence of the status message. When a programmatic means of identifying the presence of status messages in used, assistive technologies such as screen readers are able to alert users to the presence of the message.
NOTE: Status messages are defined as a change in content that is not a change of context (i.e. moving focus to a message) that provides information to the user on: 1) the success or results of an action ("Your form was successfully submitted"), 2) the loading state of an application ("processing your data request"), 3) the progress of a process ("50% complete"), or 4) the existence of errors ("Please correct the errors below to continue").
- is cloned by
WEBUI-515 Make notifications announced by the screen reader