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

Make file upload progress announced by the screen reader

    XMLWordPrintable

    Details

    • Type: Improvement
    • Status: Resolved
    • Priority: Major
    • Resolution: Fixed
    • Affects Version/s: 3.0.6
    • Fix Version/s: 3.0.17
    • Component/s: A11y

      Description

      Related to WCAG 2.1 level AA criteria 4.1.3: status messages
      https://www.w3.org/TR/WCAG21/#status-messages

      Status message is not automatically announced by the screen reader.

      Element:

      • Uploading status progress indicator below the uploaded file names in the "Import" tab

      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 ONE of the following techniques:
      1. Set focus to the interstitial message: https://dequeuniversity.com/class/dynamic-updates2/notify-users/move-focus
      2. Announce the interstitial message via an ARIA live region: https://dequeuniversity.com/class/dynamic-updates2/notify-users/aria-live

      REFERENCE:
      Deque University: https://dequeuniversity.com/class/dynamic-updates2/ajax/interstitial
      WCAG Understanding document: https://www.w3.org/WAI/WCAG21/Understanding/status-messages

      BACKGROUND:
      When the user requests an action that will take a long time to complete, such as searching for airline tickets, it is common to present an interstitial or intermediate page to users as a way to confirm that the link worked, and that the results are coming if they wait. Screen reader and other assistive technology users need that same kind of confirmation. Moving focus to the interstitial message benefits both screen reader users and screen magnification users.

        Attachments

          Issue Links

            Activity

              People

              • Votes:
                0 Vote for this issue
                Watchers:
                2 Start watching this issue

                Dates

                • Created:
                  Updated:
                  Resolved: