Writing & StyleStyle guide

Writing Accessible Treeitem Labels

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

Quick answer

Use concise visible tree-item text that identifies that node; nested child items should not be treated as part of the parent item’s label.

Key details

Core IssueW3C APG says treeitem elements are normally named from descendant content and excludes content inside a child group from the treeitem name calculation.
Registerweb accessibility and interface content

Important caveats

Scope Boundary

This page covers treeitem wording; tree-container naming, expansion state, selection, and keyboard interaction remain separate concerns.

Further guidance

Content

Write each tree-item label for the node itself so users can distinguish sibling items without incorporating the names of nested descendants.

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