Writing & StyleStyle guide

Writing Accessible Separator Labels

Writing Accessible Separator Labels records a distinct W3C-supported interface-content task while keeping implementation mechanics outside the writing guidance.

Quick answer

When multiple focusable separators need to be distinguished, use short purpose-based labels rather than generic numbering.

Key details

Core IssueW3C APG says naming a focusable separator is discretionary but recommended when more than one focusable separator appears and a name can clarify its purpose.
Registerweb accessibility and interface content

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.

  1. 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.

Explore the topic