# XWUICascader

A read-only text input that opens a chain of side-by-side menus for drilling into hierarchical data one level at a time (country to state to city). Each `options` entry may carry `children`, and the chosen path is shown as a `label / label / label` string. Set `expandTrigger` to `'hover'` to open sub-menus on mouse-over, or `changeOnSelect: true` to emit a change as soon as a parent level is picked.

## Basic Usage

A region picker that cascades from country down through state to city using the default click-to-expand trigger.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: Region picker with country, state and city levels.
```

## Hover Expand

Sub-menus open on hover (file-browser style), with `changeOnSelect` committing a value at every level.

```example
file: examples/HoverExpand.ts
html: examples/HoverExpand.html
title: Hover Expand
description: Sub-menus expand on hover and commit on each selection.
```

## Preselected Department

An employee-transfer form that opens with an existing value path already selected.

```example
file: examples/PreselectedDepartment.ts
html: examples/PreselectedDepartment.html
title: Preselected Department
description: Cascader initialised with a pre-chosen Division to Team path.
```

## Custom Separator

A category picker that formats the selected path with breadcrumb arrows via displayRender.

```example
file: examples/CustomSeparator.ts
html: examples/CustomSeparator.html
title: Custom Separator
description: Selected path rendered with custom " › " separators.
```

```api
```