Writing Accessible Toolbar Labels
Writing Accessible Toolbar Labels records the APG-supported naming task for toolbar containers and keeps it distinct from labels on the individual buttons or controls inside the toolbar.
Give a toolbar a concise label that describes the purpose of the controls it groups.
Key details
Important caveats
Scope Boundary
This page covers toolbar-name wording; arrow-key behavior, focus management, control order, and orientation remain implementation concerns.
Further guidance
Content
Label a toolbar by the purpose of the grouped controls so users can identify what that toolbar is for.
Practical Application
Label the toolbar by the purpose of the controls it groups, using wording that distinguishes it from other toolbars rather than naming the generic role.
Purpose
A purpose-based toolbar label helps users understand the function of the control group when navigating composite widgets.
Reader Check
Would the label still make sense if announced without the nearby page heading?
Worked Example
Example: Use “Text formatting” for a toolbar that groups bold, italic, list, and alignment controls.
Sources and evidence
Sources are shown with the role they play in this guide. Historical or style-sensitive claims are kept within the evidence boundary described above.
- Toolbar Pattern — WAI-ARIA Authoring Practices Guide (opens in a new tab)World Wide Web Consortium (W3C) · W3C APG guidance for giving a toolbar an accessible label that describes the grouped controls.