Uploaded image for project: 'Jira Data Center'
  1. Jira Data Center
  2. JRASERVER-73824

Issue Navigator- Search : Menus are inaccessible for JAWS & NVDA screen reader users.

    XMLWordPrintable

Details

    Description

      Issue Summary

      On search page, the 'Export' & 'Tools' menu is inaccessible for JAWS & NVDA screen reader users.

      Similar issue is observed for filter actions menu for favourite filters.

      Steps to Reproduce

      1. Turn on the screen reader such as "JAWS" or "VoiceOver"
      2. Navigate to the Jira Dashboard page.
      3. Navigate to the "Issues" menu inside header section.
      4. Activate "Search for issues" link from the menu.
      5. Navigate to the "Exports" or "Tools" button in main content.
      6. Press "enter" to activate the buttons.
      7. Try to use up/down arrow keys to navigate through options.
      8. Observe that the focus moves to next elements in the page.

      Actual Results

      While navigating with a screen reader such as JAWS, when user actives the "Export" , "Tools" or favourite filter menu button & press up/down arrow keys to navigate through the options, the screen reader focus moves to the next element on the page.

      Currently the only way to navigate to the options is to press 'tab' keys until the focus reaches to the options which is very frustrating experience.

      Following are some of the Issues which are likely to be causing the above issue.

      • With down arrow the menu does not expand.
      • after expanding the menu, the focus does not go to the first option explicitly 
      • The code of the menu item container is placed at the end of the page in DOM order incorrectly.
      • The ARIA role="menu" is provided to the <div> element incorrectly.
      • The <li> elements doesn’t have the role="presentation" attributes.
      • Menuitems are marked inside separate <ul> element incorrectly.

      Note : The focus related issue with up/down arrow keys is not observed with VoiceOver in safari. It is only observed with JAWS & NVDA screen reader.

      Expected Results

      The "Export","Tools" & filter actions menu options should be accessible with all screen readers & keyboard up/down arrow keys.

      Following changes in the source code will most likely fix the above mentioned issues.

      • Menu should get expanded with enter/space/down arrow keys.
      • As soon as the menu is expanded set the focus to the first menu option.
      • Place the code of the menu item container right after the code of menu button inside the DOM order. This makes sure that the visual order of the element matches with the DOM order.
      • Remove the role="menu" attribute from the <div> element & provide it to the parent <ul> element.
      • Provide role="presentation" or role="none" to all the <li> elements inside menu since those don’t need to be rendered as list items to SR users.
      • Provide all the menuitems inside a single <ul> element.

      Please refer to the following example of the menu button to understand more.

      https://www.w3.org/WAI/ARIA/apg/example-index/menu-button/menu-button-links.html 

      Use below link to read detailed documentation on accessible menu buttons.

      https://hello.atlassian.net/wiki/spaces/A11Y/pages/1518212759/Menu+Buttons 

      Screenshot

      Exports menu 

      Favourite filters menu

      Screen recording

      Exports & tools menu.mp4

      Workaround

      Currently there is no known workaround for this behaviour. A workaround will be added here when available

      Attachments

        1. 73824-QA-Verification-JAWS.mp4
          2.44 MB
        2. 73824-QA-Verification-NVDA.mp4
          2.12 MB
        3. 73824-QA-Verification-Voicover.mov
          37.48 MB
        4. Exports & tools menu.mp4
          841 kB
        5. Screenshot 2022-05-23 at 1.47.14 PM.png
          Screenshot 2022-05-23 at 1.47.14 PM.png
          587 kB
        6. Screenshot 2022-08-08 at 5.03.34 PM.png
          Screenshot 2022-08-08 at 5.03.34 PM.png
          910 kB

        Issue Links

          Activity

            People

              aee694511cd1 Olena Lymar
              4b5b126a48d0 ssuryavanshi
              Votes:
              2 Vote for this issue
              Watchers:
              3 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved: