MultiCascader 级联多项选择器
对有层级关系结构的数据进行多项选择。
<MultiCascader>
获取组件
import { MultiCascader } from 'rsuite';演示
默认
外观
尺寸
级联选择
默认值
受控
撑满
位置
自定义选项
禁用
不可选状态
异步
容器与防止溢出
Inline
Props
<MultiCascader>
| 属性名称 | 类型(默认值) |
描述 |
|---|---|---|
| appearance | enum: 'default', 'subtle' ('default') |
设置外观 |
| block | boolean | 堵塞整行 |
| cascade | boolean (true) |
是否级联选择 |
| childrenKey | string ('children') |
设置选项子节点在 data 中的 key |
| classPrefix | string ('picker') |
组件 CSS 类的前缀 |
| cleanable | boolean (true) |
可以清除 |
| container | HTMLElement or (() => HTMLElement) | 设置渲染的容器 |
| countable | boolean (true) |
可以计数已选项 |
| data * | Array<DataItemType> | 组件数据 |
| defaultOpen | boolean | 默认打开 |
| defaultValue | string[] | 设置默认值 |
| disabled | boolean | 禁用组件 |
| disabledItemValues | string[] | 禁用选项 |
| height | number (320) |
设置 Dropdown 的高度 |
| inline | boolean | 在组件初始后直接展示菜单 |
| labelKey | string ('label') |
设置选项显示内容在 data 中的 key |
| menuClassName | string | 选项菜单的 className |
| menuHeight | number (200) |
设置菜单的高度 |
| menuWidth | number (156) |
设置菜单的宽度 |
| onChange | (value:string[] , event: SyntheticEvent) => void | value 发生改变时的回调函数 |
| onCheck | ( value: ValueType, item: DataItemType, checked: boolean,event ) => void; | 复选框选中状态发生变化的回调函数 |
| onClean | (event:SyntheticEvent) => void | 值清理时触发回调 |
| onClose | () => void | 关闭回调函数 |
| onEnter | () => void | 显示前动画过渡的回调函数 |
| onEntered | () => void | 显示后动画过渡的回调函数 |
| onEntering | () => void | 显示中动画过渡的回调函数 |
| onExit | () => void | 退出前动画过渡的回调函数 |
| onExited | () => void | 退出后动画过渡的回调函数 |
| onExiting | () => void | 退出中动画过渡的回调函数 |
| onOpen | () => void | 打开回调函数 |
| onSearch | (searchKeyword:string, event: SyntheticEvent) => void | 搜索的回调函数 |
| onSelect | (item:DataItemType, activePaths: Array, concat:(data, children) => Array, event: SyntheticEvent) => void | 选项被点击选择后的回调函数 |
| open | boolean | 打开 (受控) |
| placeholder | React.Node ('Select') |
占位符 |
| placement | enum: PlacementStart('bottomStart') |
打开位置 |
| preventOverflow | boolean | 防止浮动元素溢出 |
| renderExtraFooter | () => React.Node | 自定义页脚内容 |
| renderMenu | (children: object[], menu:React.Node, parentNode?: object) => React.Node | 自定义渲染菜单列表 |
| renderMenuItem | (label:React.Node, item: DataItemType) => React.Node | 自定义选项 |
| renderValue | (value:string[],selectedItems: Array<DataItemType>,selectedElement:React.Node ) => React.Nodee | 自定义被选中的选项 |
| searchable | boolean (true) |
可以搜索 |
| size | enum: 'lg', 'md', 'sm', 'xs' ('md') |
设置组件尺寸 |
| toggleComponentClass | React.ElementType ('a') |
为组件自定义元素类型 |
| uncheckableItemValues | string[] | 设置不显示复选框的选项值 |
| value | string[] | 设置值（受控） |
| valueKey | string ('value') |
设置选项值在 data 中的 key |