Skip to content

Improve the block inserter labeling #61483

@afercia

Description

@afercia

Description

Noticed after some recent changes to the block inserter in #61004 and #61421. Hat tip to @carolinan for pointing me at this.

Title case capitalization

Traditionally, all WordPress features are title case. The term 'block inserter' feels a little too technical to me and I'd personally prefer a more intuitive, simpler name. Regardless, whatever this feature name is, it should be always title case: Block Inserter. This is no different for other features e.g. List View, Document Overview, and many other ones.
Title case should be used everywhere the 'Block Inspector' terminology is used, for example also in the commands palette.

The verb 'toggle'

See #42492 and similar trac ticket for Core. The verb 'toggle' should be avoided. The button that opens the Inserter is labeled aria-label="Toggle block inserter". Also, for consistency, Document Overview, List View, Settings panel don't use the verb 'toggle'. It is used in the command palette and it should be removed from there as well.

The name 'Block Library' is obsolete

The navigable region where the block inserter renders within is still labeled 'Block Library'. This should be updatred to 'Block Inerter' as it's confusing for screen reader users. They will activate a button labeled 'Block inserter' to get a UI that is labeled 'Block Lirary'. Screenshot with VoiceOver running:

Screenshot 2024-05-08 at 12 20 29

The new Close button label should be simplified

In #49614 some labels for some Close buttons were simplified based on the following criteria:

  • When the Close button is contained within a labelled UI that provides enough context, shorten the button label to just 'Close'.
  • Otherwise, keep some contextual information in the button label.

In the same way, as this UI is already labeled, the Close button label should be simplified.

Step-by-step reproduction instructions

Observe the labels used in the UI in the places described above.

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    Needs Design FeedbackNeeds general design feedback.[Feature] InserterThe main way to insert blocks using the + button in the editing interface[Focus] Accessibility (a11y)Changes that impact accessibility and need corresponding review (e.g. markup changes).[Type] BugAn existing feature does not function as intended

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions