Writing & StyleStyle guide

Writing Accessible Treegrid Descriptions

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

Quick answer

Use a brief description when a treegrid needs context beyond its label, such as what the hierarchy contains or how the data is organized.

Key details

Core IssueW3C APG says a treegrid may reference a caption or other descriptive content with aria-describedby in addition to its accessible name.
Registerweb accessibility and interface content

Important caveats

Scope Boundary

This page covers optional treegrid description content; treegrid naming, row/cell labels, and interaction behavior remain separate tasks.

Further guidance

Content

Write the description to add context that the treegrid name alone does not convey, while keeping the label itself concise.

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