Skip to content

Fix #56: replace customize-mode hamburger icon with pencil + clearer tooltip#65

Open
lucasmendes-design wants to merge 1 commit into
trunkfrom
lucasmdo/customize-icon-pencil-56
Open

Fix #56: replace customize-mode hamburger icon with pencil + clearer tooltip#65
lucasmendes-design wants to merge 1 commit into
trunkfrom
lucasmdo/customize-icon-pencil-56

Conversation

@lucasmendes-design
Copy link
Copy Markdown
Collaborator

Summary

Four independent testers in the May 2026 usability round were confused by the three-lines (hamburger) icon used to enter customize mode on the My Plugins group — the strongest single signal of the round. This PR addresses that:

  • Icon: hamburger → Gutenberg pencil (@wordpress/icons pencil).
  • Tooltip / aria-label: Customize pluginsEdit plugin order — describes the only action the mode performs (drag-drop reorder) and matches a tester's natural wording ("I clicked here to reorder").
  • Tooltip position: now horizontally centred on the icon so it reads as attached to the affordance.

Closes #56.

Implementation

  • Added src/browse-rail/icons/pencil.svg (path lifted verbatim from @wordpress/icons/build-module/library/pencil.js).
  • styles.css: mask URL points to the new SVG; tooltip anchor switched from right: 0 to left: 50%; transform: translateX(-50%).
  • grouping.js: updated aria-label and data-tooltip strings; refreshed the translator comment.
  • Deleted the no-longer-referenced list-view.svg.

No behaviour change — the click handler, A.1 disabled state, and customize-mode entry logic are all unchanged.

Test plan

  • Open /wp-admin/ with the plugin active → My Plugins header shows a pencil icon (not three lines).
  • Hover the pencil → tooltip "Edit plugin order" appears after ~250 ms, horizontally centred on the icon.
  • Focus the pencil via keyboard (Tab) → same tooltip appears.
  • Click → customize mode still enters as before.
  • prefers-reduced-motion: reduce → tooltip shows/hides without transition delay (existing behaviour preserved).
  • Auto-fold (collapsed sidebar) layout → pencil still renders correctly in the narrow column.

🤖 Generated with Claude Code

…tooltip

Four independent testers in the May 2026 usability round were confused by
the three-lines icon — the strongest single signal of the round. Swap it
for the Gutenberg pencil icon and replace the "Customize plugins" tooltip
with "Edit plugin order", which describes the only action the mode
performs (drag-drop reorder) and matches a tester's natural wording.
Centre the tooltip horizontally on the icon so it reads as attached to
the affordance.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@chriskmnds chriskmnds added the pending: Calypso-parity Not yet implemented on the Calypso side. label May 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

pending: Calypso-parity Not yet implemented on the Calypso side.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Replace the hamburger icon for customize entry

2 participants