Writing Accessible Treegrid Labels
Writing Accessible Treegrid Labels records a distinct W3C-supported interface-content task while keeping implementation mechanics outside the writing guidance.
Give a treegrid a concise label that identifies the hierarchical data set or task it contains.
Key details
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.
Practical Application
Name the treegrid for the hierarchical data set or task as a whole, using a concise phrase that distinguishes it from nearby tables, grids, or other treegrids.
Purpose
Clear wording helps assistive-technology users understand the component or content in context without relying on implementation details.
Reader Check
Could a user identify this treegrid from its name without hearing its row or cell contents first?
Worked Example
Example: Use “Project task hierarchy” for a treegrid of nested projects, tasks, owners, and status values.
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.
- 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.