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.
Browse hierarchical records with controlled disclosure and selection.
Native example
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 label="Files" nodes={nodes} expandedIds={expanded} onExpandedChange={setExpanded} selectedIds={selected} onSelectionChange={setSelected} />Reference
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
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.
Localized disclosure and depth with native selection controls and inherited disabled state.
Shared component