Async

Async children loading

react-tree-multi-select supports lazy loading of node children via the onLoadChildren prop. Children are loaded on demand when the user expands a node that declares it has children (hasChildren: true).

Expansion and loading behavior

1. A node is rendered with hasChildren: true
2. The user expands the node
3. The component calls onLoadChildren(nodeId)
4. The returned children are merged into the tree
5. The node is expanded and rendered with its loaded children

Selection behavior

Uncontrolled mode

When the component manages its own selection state (selectedIds is not provided):

• If a selected parent node loads children asynchronously, those children are automatically selected
• A single onNodeChange callback is triggered after the children are loaded and auto-selected, and it is invoked for the parent node that was expanded

Controlled mode

When selectedIds is provided:

• The component does not auto-select asynchronously loaded children
• The parent application is responsible for updating selectedIds
• This guarantees that the external state remains the single source of truth