When to use it
Branches browse and enabled selectable leaves emit full canonical paths. Retain unknown paths until the host replaces them. Read-only selection permits browsing; app routing stays in the host.
FormsReact Native
Cascader
Select a stable leaf path through native branch drill-down.
Native example
Use Cascader
Branches browse and enabled selectable leaves emit full canonical paths. Retain unknown paths until the host replaces them. Read-only selection permits browsing; app routing stays in the host.
View captured React Native example
<LumenCascader label="Destination" nodes={nodes} selectedPath={path} onSelectionChange={setPath} />Reference
Public API
The primary shared and platform-specific options exposed by LumenCascader.
| API | Values or type | Default | Description |
|---|---|---|---|
| nodes / selectedPath | LumenTreeNode records / controlled ordered IDs | Required | Controls a canonical path over the validated shared tree model. |
| readOnly / loading / error | Platform state values | Editable / ready / no error | Guards selection and hides stale result controls. |
| backLabel / formatDisclosure | Localized text / formatter | English defaults | Names native drill-down navigation. |
Native behavior
Design and accessibility
Accessibility
Localized branch and back navigation with controlled leaf selection and safe status states.
Shared component