When to use it
Use stable flat graph identities. Invalid graphs fail closed; state edits retain unknown host IDs. Read-only selection still permits disclosure. Localize depth and disclosure formatters.
Data displayApple
Tree
Browse hierarchical records with controlled disclosure and selection.
Apple availability
Supported native targets
Import LumenUI in the target that uses this component. iPad support follows the iOS package baseline and uses native iPad layout behavior.
iPhone · iOS 16+iPad · iPadOS 16+Mac · macOS 13+Apple Vision · visionOS 1+
Native example
Use Tree
Use stable flat graph identities. Invalid graphs fail closed; state edits retain unknown host IDs. Read-only selection still permits disclosure. Localize depth and disclosure formatters.
LumenTree("Files", nodes: nodes, expandedIds: $expanded, selectedIds: $selected)Reference
Public API
The primary shared and platform-specific options exposed by LumenTree.
| API | Values or type | Default | Description |
|---|---|---|---|
| nodes | LumenTreeNode records | Required | Defines stable identity, parent, label and disabled/selectable state. |
| expandedIds / selectedIds | Controlled sets | Required expansion / optional selection | Preserves host state through hidden and unavailable nodes. |
| loading / error / readOnly | Platform state values | Ready / no error / editable | Hides stale controls during result states and guards mutations. |
Native behavior
Design and accessibility
Accessibility
Localized disclosure and depth with native selection controls and inherited disabled state.
Shared component