Writing & StyleStyle guide

Writing Accessible Scrollbar Labels

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

Quick answer

When a custom scrollbar needs a name, label it for the content area or purpose it controls rather than with a generic word such as “scrollbar.”

Key details

Core IssueW3C APG says a scrollbar may be named to help users understand its purpose, using visible referenced text when available or another accessible name.
Registerweb accessibility and interface content

Important caveats

Scope Boundary

This page covers optional scrollbar-name wording; aria-controls, value properties, orientation, and keyboard behavior are implementation concerns.

Further guidance

Content

Write an optional scrollbar label that identifies the associated content region when that context is not otherwise clear.

Purpose

Clear wording helps assistive-technology users understand the component or content in context without relying on implementation details.

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