Writing Accessible Separator Labels
Writing Accessible Separator Labels records a distinct W3C-supported interface-content task while keeping implementation mechanics outside the writing guidance.
When multiple focusable separators need to be distinguished, use short purpose-based labels rather than generic numbering.
Key details
Important caveats
Scope Boundary
This page covers optional wording for focusable separators; purely decorative separators do not need invented labels.
Further guidance
Content
Write a separator label only when it adds useful context, such as which panels or regions the separator resizes or divides.
Practical Application
When a focusable separator functions as a resizer and needs to be distinguished, label the boundary or pane it adjusts rather than using generic numbering or merely the word “separator.”
Purpose
Clear wording helps assistive-technology users understand the component or content in context without relying on implementation details.
Reader Check
Would the label make the resize effect predictable before the user changes the separator position?
Worked Example
Example: Label a focusable splitter “Resize navigation pane” when it changes the width of the navigation area.
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.
- Providing Accessible Names and Descriptions — W3C WAI ARIA APG (opens in a new tab)W3C Web Accessibility Initiative · W3C WAI-ARIA Authoring Practices guidance for descriptive accessible names, visible labels, and button/control naming.