Documentation
API: primitives (@fragiola/tree-react, @fragiola/tree-vue, @fragiola/tree-angular)

Tree.Toggle

Expands or collapses the enclosing item on a press. A pointer affordance hidden from assistive technology, since the item carries aria-expanded.

Tree.Toggle expands or collapses its item on a press (item.toggle). It is a pointer affordance: the keyboard expands with the arrows on the item, which carries aria-expanded, so the toggle is aria-hidden and never takes focus, as the WAI-ARIA APG tree view expects. It renders a span with what you give it (a chevron) and no icon of its own, on a leaf too, with data-leaf.

<Tree.ItemContent className="row">
    <Tree.Toggle className="toggle">
        <ChevronRight aria-hidden />
    </Tree.Toggle>
    <span>{item.label}</span>
</Tree.ItemContent>
.toggle[data-leaf] {
    visibility: hidden; /* keeps the room, so labels line up */
}
.toggle[data-expanded] {
    rotate: 90deg;
}

A press on it never selects the row or starts a drag.

Props

ToggleProps extends the common primitive props (on a span), with the item's state (TreeItemState).

proptypedescription
childrenReactNodewhat it shows (a chevron); no text and no icon of its own

Attributes

attributewhen
aria-hiddenalways
data-tree-part="toggle"always
the item's data-* statedata-expanded, data-leaf, data-loading, … (State attributes)

On this page