Semantics
A grid whose rows can be expanded and collapsed in the same manner as for a tree.
Additional info from the ARIA specification
If aria-readonly is set on an element with role treegrid, user agents MUST propagate the value to all gridcell elements that are accessibility descendants of the treegrid and expose the value in the accessibility API. An author MAY override the propagated value of aria-readonly for an individual gridcell element.
When the aria-readonly attribute is applied to a focusable gridcell, it indicates whether the content contained in the gridcell is editable. The aria-readonly attribute does not represent availability of functions for navigating or manipulating the treegrid itself.
In a treegrid that provides content editing functions, if the content of a focusable gridcell element is not editable, authors MAY set aria-readonly to true on the gridcell element. However, if a treegrid presents a collection of elements that do not support aria-readonly, such as a collection of link elements, it is not necessary for the author to specify a value for aria-readonly.
To be keyboard accessible, authors SHOULD manage focus of descendants for all instances of this role, as described in Managing Focus.
Abstract Role
CompositeRepresents a container for navigating interactive descendants.
Content Categories
Flow ContentAn element that structures and organizes the body of a web document.
Allowed Descendants
Specific Guidance
Only row and rowgroup roles allowed.
Usage
Allowed HTML elements
Implicit semantics
- None
Explicitly allowed
- None
Elements that can have any role
abbr[role=treegrid]address[role=treegrid]b[role=treegrid]blockquote[role=treegrid]canvas[role=treegrid]cite[role=treegrid]code[role=treegrid]custom-element[role=treegrid]data[role=treegrid]del[role=treegrid]dfn[role=treegrid]div[role=treegrid]em[role=treegrid]figure[role=treegrid]i[role=treegrid]ins[role=treegrid]kbd[role=treegrid]mark[role=treegrid]output[role=treegrid]p[role=treegrid]pre[role=treegrid]q[role=treegrid]samp[role=treegrid]small[role=treegrid]span[role=treegrid]table[role=treegrid]tbody[role=treegrid]tfoot[role=treegrid]thead[role=treegrid]time[role=treegrid]u[role=treegrid]var[role=treegrid]