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

Make the nuxeo-document-tree announce loading when browsing



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


      In Web UI, use the browse drawer item and click the left arrow besides a document title
      While children documents are loading, the status message is not provided to a screeen reader.
      Expected: status message should be provided to a screen reader tool.


      Status message is not automatically announced by the screen reader.
      "Root", "Domain", "Workspace" etc. links
      "Root", "Domain", "Workspace" etc. links present in the navigation tree

      Currently upon activating the above mentioned links there is this loading animation shown to convey the loading information but the same information is not conveyed to the screen reader users.
      Recommendation to fix
      RULE :
      Screen reader users MUST be informed when a web page launches an interstitial view, a progress indicator, or enters into a paused or busy state.

      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

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

      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.


          Issue Links



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


                • Created: