-
Notifications
You must be signed in to change notification settings - Fork 4.8k
"Slash menu": improve instructions and feedback #5592
Copy link
Copy link
Closed
Labels
Needs DevReady for, and needs developer effortsReady for, and needs developer efforts[Focus] Accessibility (a11y)Changes that impact accessibility and need corresponding review (e.g. markup changes).Changes that impact accessibility and need corresponding review (e.g. markup changes).[Status] In ProgressTracking issues with work in progressTracking issues with work in progress[Type] BugAn existing feature does not function as intendedAn existing feature does not function as intended
Metadata
Metadata
Assignees
Labels
Needs DevReady for, and needs developer effortsReady for, and needs developer efforts[Focus] Accessibility (a11y)Changes that impact accessibility and need corresponding review (e.g. markup changes).Changes that impact accessibility and need corresponding review (e.g. markup changes).[Status] In ProgressTracking issues with work in progressTracking issues with work in progress[Type] BugAn existing feature does not function as intendedAn existing feature does not function as intended
Type
Fields
Give feedbackNo fields configured for issues without a type.
Follow up to #5591 to address the second part of the feedback we're getting from assistive technologies users. For full details, please refer to #5591.
Screen reader users are able to use the slash menu. However, only 10 block types are displayed by default and there are no instructions that typing actually filters the list and makes new results appear in the menu.
In the test session reported on #5591 the user had a simple task: add a table with 2 columns, 2 rows and add some data in the cells
The feedback was:
I'm wondering if this applies also to sighted users: they can certainly try to type something and they will see the menu changes, but maybe discoverability is not that great.
Unfortunately, the audible message used for screen reader users is always the same for all the auto-completers in Gutenberg. It's always:
nn results found, use up and down arrow keys to navigate.In this specific case, screen reader users need some more context and a meaningful message instructing them to type to refine the search results.
Once they start typing, I think the feedback is good enough. The only issue is the initial message and instructions, clearly not sufficient to understand how this feature works.
Why the initial message "10 results found, use up and down arrow keys to navigate." is confusing?
I guess because users have typed just a slash
/. Actually, they haven't typed any search term but they get a message that says10 results found. Instead, the message should briefly reflect what actually happens in the UI:To communicate this, there's the need of a different message.
I'd propose to consider a way to make each autocompleter have its own message. One size doesn't fit all. These auto-completers work in different ways and they need to be communicated with different, meaningful messages.
Optionally, it would be great to have 2 different messages based on the user workflow: