Skip to content

"Slash menu": improve instructions and feedback #5592

@afercia

Description

@afercia

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:

When I hit slash, table wasn't included in the menu.

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.

screenshot 77

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.

screenshot 78

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 says 10 results found. Instead, the message should briefly reflect what actually happens in the UI:

  • 10 initial choices are displayed
  • typing something will display other search redsults

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:

  • a message when the menu opens for the first time
  • a different message for the search results

Metadata

Metadata

Assignees

Labels

Needs DevReady for, and needs developer efforts[Focus] Accessibility (a11y)Changes that impact accessibility and need corresponding review (e.g. markup changes).[Status] In ProgressTracking issues with work in progress[Type] BugAn existing feature does not function as intended

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions