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



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


      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.

      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>

      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 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").


          Issue Links



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


                • Created:

                  Time Tracking

                  Original Estimate - Not Specified
                  Not Specified
                  Remaining Estimate - 0 minutes
                  Time Spent - 1 day