Uploaded image for project: 'Nuxeo Web UI'
  1. Nuxeo Web UI
  2. WEBUI-515

Make notifications announced by the screen reader


    • Type: Improvement
    • Status: Open
    • Priority: Major
    • Resolution: Unresolved
    • Affects Version/s: 3.0.6
    • Fix Version/s: None
    • Component/s: A11y


      Related to WCAG 2.1 level AA criteria 4.1.3: status messages

      Status message is not automatically announced by the screen reader.

      Elements: Below status message that appears on activating the "Add to favorites" or "Remove from favorites" button:

      • "Document added to favorites"
      • "Document removed from favorites"


      • "Search results" section

      Recommendation to fix
      RULE :
      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>

      Deque University:https://dequeuniversity.com/class/dynamic-updates2/notify-users/aria-live
      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").


          Issue Links



              • Assignee:
                bchauvin Bertrand Chauvin
              • Votes:
                0 Vote for this issue
                1 Start watching this issue


                • Created:


                  Error rendering 'com.pagerduty.jira-server-plugin:PagerDuty'. Please contact your Jira administrators.