Writing & StyleStyle guide

Writing Accessible Treegrid Labels

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

Quick answer

Give a treegrid a concise label that identifies the hierarchical data set or task it contains.

Key details

Core IssueW3C APG says a treegrid uses aria-labelledby when a visible label exists, otherwise aria-label; a separate caption or description may be referenced with aria-describedby.
Registerweb accessibility and interface content

Important caveats

Scope Boundary

This page covers the treegrid container’s name; cell content, row labels, and an optional longer description are separate content tasks.

Further guidance

Content

Write the treegrid label to distinguish the widget as a whole from other grids, tables, or regions on the page.

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. Treegrid Pattern — WAI-ARIA Authoring Practices Guide (opens in a new tab)World Wide Web Consortium (W3C) · W3C APG guidance for naming treegrid widgets and associating an optional caption or description.

Explore the topic