> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rebellapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# my.multiLevelSelect

> Display a multi-level cascading selector.

Use this API to show a cascading picker for hierarchical data selection.

## Parameters

| Property | Type      | Required | Description                                        |
| -------- | --------- | -------- | -------------------------------------------------- |
| title    | String    | No       | Selector title                                     |
| list     | JsonArray | Yes      | Selection data list                                |
| name     | String    | Yes      | Entry name (property of each object in `list`)     |
| subList  | JsonArray | No       | Sub-entry list (property of each object in `list`) |
| success  | Function  | No       | Callback with selection                            |
| fail     | Function  | No       | Callback on failure                                |
| complete | Function  | No       | Callback that always executes                      |

## Success Callback

| Property | Type      | Description                                                                              |
| -------- | --------- | ---------------------------------------------------------------------------------------- |
| success  | Boolean   | Whether selection was successful (returns `false` for cancellation)                      |
| result   | JsonArray | Selected items array, e.g. `[{"name":"City"},{"name":"District A"},{"name":"Street A"}]` |

## Code Example

```javascript theme={null}
my.multiLevelSelect({
  title: 'Select Location',
  list: [
    {
      name: 'USA',
      subList: [
        { name: 'California' },
        { name: 'New York' }
      ]
    }
  ],
  success: (res) => {
    console.log('Selected:', res.result);
  }
});
```

## Related APIs

<CardGroup cols={2}>
  <Card title="my.datePicker" icon="calendar" href="/jsapi/ui/choose-date/my.datePicker">
    Date picker
  </Card>
</CardGroup>