Uploaded image for project: 'Nuxeo Elements'
  1. Nuxeo Elements
  2. ELEMENTS-1539

Make search results loading in queue view and listing announced by screen reader

    XMLWordPrintable

    Details

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

      Description

      Make search results loading in queue view and listing announced by screen reader

      When doing a search:

      • while loading the queue view
      • while loading the search results

      the loading message is not announced by the screen reader.
      Expected: loading status should be announced by the screen reader.

      Status message is not automatically announced by the screen reader.

      _________________________

      Element Name: Loading information

      Location: Homepage-> Select Search from Left Navigation-> Select 'Switch to Queue view' -> Select any element form list, respective document opens in main region of the page. Navigate to 'Comments' section in the bottom of the page in common section.

      Description:
      1. Loading information is not being narrated by NVDA upon searching the pattern from Search filters pane.
      2. NVDA is not narrating loading information after selecting a file in the Table or Grid view.
      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>

      REFERENCE:
      Deque University:https://dequeuniversity.com/class/dynamic-updates2/notify-users/aria-live
      WCAG Understanding document: https://www.w3.org/WAI/WCAG21/Understanding/status-messages

      BACKGROUND:
      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 is 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").

        Attachments

          Issue Links

            Activity

              People

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

                Dates

                • Created:
                  Updated:
                  Resolved:

                  Time Tracking

                  Estimated:
                  Original Estimate - Not Specified
                  Not Specified
                  Remaining:
                  Remaining Estimate - 0 minutes
                  0m
                  Logged:
                  Time Spent - 1 day
                  1d