TagPicker
Multi-select by tag and support new options
<TagPicker>
Usage
import { TagPicker } from 'rsuite';Examples
Default
Size
Block
Group
Creatable
Custom
Disabled
Async
Props
<TagPicker>
| Property | Type(Default) |
Description |
|---|---|---|
| cacheData | Array<DataItemType> | Option to cache value when searching asynchronously |
| 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 |
| creatable | boolean (true) |
Settings can create new options |
| data * | Array<DataItemType> | The data of component |
| defaultValue | any | Default values of the selected items |
| disabled | boolean | Whether disabled componet |
| disabledItemValues | string[] | Disable item by value |
| groupBy | string | Set group condition key in data |
| labelKey | string ('label') |
Set label key in data |
| listProps | listprops | List-related properties in react-virtualized |
| maxHeight | number (320) |
The max height of Dropdown |
| menuClassName | string | A css class to apply to the Menu DOM node. |
| menuStyle | React.CSSProperties | A style to apply to the Menu DOM node. |
| onChange | (value:string, event) => void | Callback fired when value change |
| 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 |
| onGroupTitleClick | (event) => void | Callback fired when click the group title |
| onOpen | () => void | Callback fired when open component |
| onSearch | (searchKeyword:string, event) => void | Callback fired when search |
| onSelect | (value:string, item: DataItemType , event) => void | Callback fired when item is selected |
| placeholder | React.Node ('Select') |
Setting placeholders |
| placement | enum: Placement('bottomStart') |
The placement of component |
| preventOverflow | boolean | Prevent floating element overflow |
| renderExtraFooter | () => React.Node | Custom render extra footer |
| renderMenuGroup | (groupTitle:React.Node, item:DataItemType) => React.Node | Custom render menu group |
| renderMenuItem | (label:React.Node, item: DataItemType) => React.Node | Custom render menu items |
| renderValue | (value: any[], items: any[],selectedElement:React.Node) => React.Node | Custom render selected items |
| searchBy | (keyword: string, label: React.ReactNode, item: ItemDataType) => boolean | Custom search rules |
| searchable | boolean (true) |
Whether dispaly search input box |
| size | enum: 'lg', 'md', 'sm', 'xs' ('md') |
A picker can have different sizes |
| sort | (isGroup: boolean) => (a: any, b: any) => number | Sort options |
| tagProps | tagprops | Set the props of the Tag |
| toggleComponentClass | React.ElementType ('a') |
You can use a custom element for this component |
| value | any | Specifies the values of the selected items (Controlled) |
| valueKey | string ('value') |
Set value key in data |
| virtualized | boolean (true) |
Whether using Virtualized List |