Writing Accessible Listbox Option Labels
Writing Accessible Listbox Option Labels captures the APG’s explicit content guidance on spoken option names rather than duplicating generic form-label advice.
Keep listbox option names concise and distinguish choices early; avoid long labels and repeated leading phrases that users must hear on every option.
Key details
Important caveats
Scope Boundary
This page covers wording of option names; selection state, grouping, focus movement, and listbox keyboard interaction remain implementation concerns.
Further guidance
Content
Keep each option name concise enough to understand as one spoken unit, and put the distinguishing information early instead of repeating the same long prefix on every option.
Practical Application
Keep option names concise, put the distinguishing information early, and remove a repeated prefix when every option starts with the same words and that repetition does not aid understanding.
Purpose
Shorter, differentiated option names reduce repeated speech and make it faster to identify choices while navigating a listbox.
Reader Check
When moving through options one by one, can a user hear the difference quickly without waiting through the same long phrase each time?
Worked Example
Example: Under the listbox label “Office location,” use options “Delhi,” “Kolkata,” and “Mumbai” rather than repeating “Office location —” before every city.
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.
- Listbox Pattern — WAI-ARIA Authoring Practices Guide (opens in a new tab)World Wide Web Consortium (W3C) · W3C APG guidance for listbox and option-group accessible naming, plus concise option wording and repeated-prefix cautions.