Page MenuHomePhabricator

Screenreader support: Help button interaction lacks information
Closed, ResolvedPublic

Description

Each input field in the search interface is preceded by an help button that opens a longer tooltip with a description and instructions on how to use the field. The button can be focused an the popup can be opened with Space and closed with Escape. For a screenreader this workflow is not very transparent. The button can be focused, but there's nothing read out. Opening the popup at least reads out the content immediately.

  • Add a title/aria-description to the help icons that explains it's function
  • If applicable apply aria-haspopup to make transparent, that triggering the button opens a popup

Note, that it might make sense to make these changes in the upstream library.

Event Timeline

"The button can be focused, but there's nothing read out" That's not true for me. Like any icon only button, it reads it's label if it has one, and this has one. I hear "Help, button".

But this definitely could use some improvement on the popup level

Change 971122 had a related patch set uploaded (by Thiemo Kreuz (WMDE); author: Thiemo Kreuz (WMDE)):

[oojs/ui@master] Fix slightly misplaced ARIA attributes on PopupButtonWidget

https://gerrit.wikimedia.org/r/971122

Change 971122 merged by jenkins-bot:

[oojs/ui@master] Fix slightly misplaced ARIA attributes on PopupButtonWidget

https://gerrit.wikimedia.org/r/971122

Change 971408 had a related patch set uploaded (by Mareike Heuer; author: Mareike Heuer):

[mediawiki/extensions/AdvancedSearch@master] Added 'aria-description' attribute to help buttons to make sure screen readers provide a clear guidance for users to click the button in order to receive instructions for both search fields and dropdown lists.

https://gerrit.wikimedia.org/r/971408

Change 971408 merged by jenkins-bot:

[mediawiki/extensions/AdvancedSearch@master] Added 'aria-description' attribute to help buttons

https://gerrit.wikimedia.org/r/971408

Change 972700 had a related patch set uploaded (by Thiemo Kreuz (WMDE); author: Thiemo Kreuz (WMDE)):

[mediawiki/extensions/AdvancedSearch@master] Document $1 parameters in qqq.json

https://gerrit.wikimedia.org/r/972700

Change 972700 merged by jenkins-bot:

[mediawiki/extensions/AdvancedSearch@master] Document $1 parameters in qqq.json

https://gerrit.wikimedia.org/r/972700

Change 980958 had a related patch set uploaded (by Anne Tomasevich; author: Anne Tomasevich):

[mediawiki/core@master] Update OOUI to v0.48.3

https://gerrit.wikimedia.org/r/980958

Change 980958 merged by jenkins-bot:

[mediawiki/core@master] Update OOUI to v0.48.3

https://gerrit.wikimedia.org/r/980958