List View: Remove aria-description in favor of aria-describedby #55165
Labels
[Feature] List View
Menu item in the top toolbar to select blocks from a list of links.
[Focus] Accessibility (a11y)
Changes that impact accessibility and need corresponding review (e.g. markup changes).
Good First Issue
An issue that's suitable for someone looking to contribute for the first time
[Status] In Progress
Tracking issues with work in progress
[Type] Bug
An existing feature does not function as intended
Description
#49907 added the ability to render an
aria-description
attribute to the List View.As pointed out in other issues and PRs,
aria-description
is new in ARIA 1.3, which is not a finalized recommendation yet. As such, we can't use it, yet. We should instead use the traditional method to provide an accessible description:aria-describedby
pointing to a hidden element containing the description.This is not just an issue about formal compliance. It's about actual support by browsers and assistive technology.
Being a new ARIA 1.3 property,
aria-description
may be supported by some new browser versions and by some new assistive technology versions. However, there is no guarantee of full support. Also, we need to support old combinaitons of browsers and (more importantly) assistive technology.That said, at the moment one of the known implementation is also buggy, so that's one more reason to not use it.
See https://twitter.com/aardrian/status/1711353551518044626
The cangelog should be updated as well.
Cc: @scruffian @andrewserong @alexstine @joedolson
Step-by-step reproduction instructions
See directly in the codebase at:
gutenberg/packages/block-editor/src/components/list-view/index.js
Line 276 in 4ce1636
Screenshots, screen recording, code snippet
No response
Environment info
No response
Please confirm that you have searched existing issues in the repo.
Yes
Please confirm that you have tested with all plugins deactivated except Gutenberg.
Yes
The text was updated successfully, but these errors were encountered: