MultiCascader
Single selection of data with hierarchical relationship structure.
<MultiCascader>
Usage
import { MultiCascader } from 'rsuite';
Examples
Default
Appearance
Size
Cascade
Default value
Controlled
Block
Placement
Tip: When set to
auto*
, try to scroll the page, or change the browser size, it will automatically appear in the right place.
Custom options
Disabled
Uncheckable
Async
Container and prevent overflow
Inline
Props
<MultiCascader>
Property | Type(Default) |
Description |
---|---|---|
appearance | enum: 'default', 'subtle' ('default') |
Set picker appearence |
block | boolean | Blocking an entire row |
cascade | boolean (true) |
whether cascade select |
childrenKey | string ('children') |
Set children key in data |
classPrefix | string ('picker') |
The prefix of the component CSS class |
cleanable | boolean (true) |
Whether the selected value can be cleared |
container | HTMLElement or (() => HTMLElement) | Sets the rendering container |
countable | boolean (true) |
Can count selected options |
data * | Array<DataItemType> | The data of component |
defaultOpen | boolean | Default value of open property |
defaultValue | string[] | Default values of the selected items |
disabled | boolean | Disabled component |
disabledItemValues | string[] | Disabled items |
height | number (320) |
The height of Dropdown |
inline | boolean | The menu is displayed directly when the component is initialized |
labelKey | string ('label') |
Set label key in data |
menuHeight | number (200) |
Sets the height of the menu |
menuWidth | number (156) |
Sets the width of the menu |
onChange | (value:string[] , event: SyntheticEvent) => void | Callback fired when value change |
onCheck | ( value: ValueType, item: DataItemType, checked: boolean,event ) => void; | Called after the checkbox state changes |
onClean | (event:SyntheticEvent) => void | Callback fired when value clean |
onClose | () => void | Callback fired when close component |
onEnter | () => void | Callback fired before the overlay transitions in |
onEntered | () => void | Callback fired after the overlay finishes transitioning in |
onEntering | () => void | Callback fired as the overlay begins to transition in |
onExit | () => void | Callback fired right before the overlay transitions out |
onExited | () => void | Callback fired after the overlay finishes transitioning out |
onExiting | () => void | Callback fired as the overlay begins to transition out |
onOpen | () => void | Callback fired when open component |
onSearch | (searchKeyword:string, event: SyntheticEvent) => void | callback function for Search |
onSelect | (item:DataItemType, activePaths: Array, concat:(data, children) => Array, event: SyntheticEvent) => void | Callback fired when item is selected |
open | boolean | Whether open the component |
placeholder | React.Node ('Select') |
Setting placeholders |
placement | enum: PlacementStart('bottomStart') |
The placement of component |
preventOverflow | boolean | Prevent floating element overflow |
renderExtraFooter | () => React.Node | custom render extra footer |
renderMenu | (children: object[], menu:React.Node, parentNode?: object) => React.Node | Customizing the Rendering Menu list |
renderMenuItem | (label:React.Node, item: DataItemType) => React.Node | Custom render menu items |
renderValue | (value:string[],selectedItems: Array<DataItemType>,selectedElement:React.Node) => React.Node | Custom render selected items |
searchable | boolean (true) |
Whether you can search for options. |
size | enum: 'lg', 'md', 'sm', 'xs' ('md') |
A picker can have different sizes |
toggleComponentClass | React.ElementType ('a') |
You can use a custom element for this component |
uncheckableItemValues | string[] | Set the option value for the check box not to be rendered |
value | string[] | Specifies the values of the selected items(Controlled) |
valueKey | string ('value') |
Set value key in data |