Cascader 级联选择

用法

单选时值是一条路径数组；multiple 时是路径数组的列表。

示例加载中...

后台配置流：Cascader 定范围，FlatSelect 定策略，滑块定阈值，TagInput 记标签。

示例加载中...

属性名	类型	默认值	说明
`modelValue`	`CascaderValue`	-	单选为一条路径，多选为路径列表。
`options`	`CascaderNode[]`	`[]`	根级选项树。
`multiple`	`boolean`	`false`	多选叶子路径，已选路径显示为标签。
`disabled`	`boolean`	`false`	禁止打开、清空与选择。
`placeholder`	`string`	`'Please select'`	未选择时的占位文本。
`searchable`	`boolean`	`true`	显示搜索框，只匹配已加载的叶子路径。
`clearable`	`boolean`	`true`	有值且未禁用时显示清空按钮。
`placement`	`PopoverPlacement`	`'bottom-start'`	根面板位置，转发给 `TxPopover`。
`dropdownOffset`	`number`	`6`	根面板偏移，转发给 `TxPopover`。
`dropdownWidth`	`number`	`260`	根面板宽度；子面板按内容在 200px 与 `dropdownMaxWidth` 间自适应。
`dropdownMaxWidth`	`number`	`520`	面板最大宽度。
`dropdownMaxHeight`	`number`	`340`	面板最大高度（px）。
`expandTrigger`	`'click' \| 'hover' \| 'both'`	`'both'`	`click` 时点击打开分支面板，其余悬停打开；点击分支行总会展开。
`load`	`(node, level) => Promise<CascaderNode[]>`	-	为无 `children` 且非 `leaf` 的节点异步加载子节点。

事件名	参数	说明
`update:modelValue`	`(v)`	选择或清空后触发，参数为新值。
`change`	`(v)`	与 `update:modelValue` 同时触发。
`open`	-	浮层打开后触发。
`close`	-	浮层关闭后触发。
`load-error`	`({ path: CascaderPath, error: unknown })`	`load` 拒绝时触发，`path` 为该节点路径；再次展开会重试。

名称	类型	说明
`open()`	`() => void`	打开浮层。
`close()`	`() => void`	关闭浮层。
`toggle()`	`() => void`	切换浮层。
`focus()`	`() => void`	聚焦触发器。
`blur()`	`() => void`	让触发器失焦。
`clear()`	`() => void`	单选清为 `undefined`，多选清为 `[]`。
`setValue(v)`	`(v) => void`	以给定值派发 `update:modelValue` 与 `change`。
`getValue()`	`() => any`	返回当前 `modelValue`。

type CascaderPath = Array<string | number>
type CascaderValue = CascaderPath | CascaderPath[] | undefined // 单选 | 多选

CascaderNode，options 中的一项：

每一级是独立浮层，以 right-start 锚定在打开它的行上，按自身文本排版；只挂载展开过的分支。
悬停移动、外部点击豁免与级联关闭由 anchor-delay 服务负责，与 TxDropdownSubmenu 相同，含安全三角。
触发器是 role="combobox"；层级是 role="listbox"，行是 role="option"，分支行另带 aria-haspopup="listbox" 与 aria-expanded。
键盘：上下移动并循环，Home / End 到首尾，ArrowRight 展开并聚焦子面板首行，ArrowLeft 关闭当前层级并交还焦点；根层级不拦截 ArrowLeft。
通往已展开面板的整条路径保持激活态。
有搜索词时，层级换成扁平的叶子路径列表；清空后恢复。

packages/tuffex/packages/components/src/cascader/index.ts