You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The main section of the Gutenberg UI are wrapped in a few ARIA landmark regions, to help assistive technologies users to navigate the UI.
Each region needs to be labelled with an aria-label attribute. I'd like to propose to improve a bit the current labels and clarify their usage in the components/higher-order/navigate-regions/README.md where there's no mention of the labels.
Screenshot from the screen reader JAWS:
Note: the word "region" is added by JAWS.
1
To distinguish the Gutenberg ARIA landmarks from the ones used in the WordPress UI, the former ones are prefixed with the word "Editor", except "Publish" which was recently added. I'd suggest to change it to "Editor Publish".
2
The "Editor toolbar" label is a bit confusing for two reasons:
there are many toolbars in Gutenberg, it would be better to specify this is the "main" or the "top" toolbar (thinking at the option "Fix Toolbar to Top")
nested within the "Editor toolbar" landmark, there's an "Editor toolbar" toolbar: using the same name for both is confusing
I'd suggest to rename the ARIA landmark region to "Editor top bar". Worth reminding these labels are not visible, they will be announced just by screen readers.
3
Improve the README.md explaining the usage of aria-label.
The text was updated successfully, but these errors were encountered:
The main section of the Gutenberg UI are wrapped in a few ARIA landmark regions, to help assistive technologies users to navigate the UI.
Each region needs to be labelled with an
aria-label
attribute. I'd like to propose to improve a bit the current labels and clarify their usage in thecomponents/higher-order/navigate-regions/README.md
where there's no mention of the labels.Screenshot from the screen reader JAWS:
Note: the word "region" is added by JAWS.
1
To distinguish the Gutenberg ARIA landmarks from the ones used in the WordPress UI, the former ones are prefixed with the word "Editor", except "Publish" which was recently added. I'd suggest to change it to "Editor Publish".
2
The "Editor toolbar" label is a bit confusing for two reasons:
I'd suggest to rename the ARIA landmark region to "Editor top bar". Worth reminding these labels are not visible, they will be announced just by screen readers.
3
Improve the README.md explaining the usage of
aria-label
.The text was updated successfully, but these errors were encountered: