MultiSelectField 下拉多选
何时使用
- 用于替代原生 select,在限定的可选性内进行选择,核心能力是 选择。
组件示例
组件属性
| 属性 | 说明 | 类型 | 默认值 | 
|---|---|---|---|
| autoWidth | 下拉菜单是否与选择器对齐 | boolean | true | 
| behavior | 表单组件显示状态 | 'NORMAL' | |
| dataSource | 设置选项 |  | |
| filter | 本地过滤方法,开启本地过滤时才有 | (value: string[], data: DataSource) => boolean |  -  | 
| filterLocal | 在数据源为远程的时候需要关闭此项,返回一个 Boolean 值确定是否保留 | boolean | true | 
| hasArrow | 设置是否有下拉箭头 | boolean | true | 
| hasBorder | 是否有边框 | boolean | true | 
| hasSelectAll | 是否有全选功能 | boolean | false | 
| label | 表单组件标题 | string |  -  | 
| labelAlign | 表单组件标题的位置 | 'left' | 'top' | 'top' | 
| labelColOffset | 设置标题的偏移位置,配置值为栅格值,1代表1/24 | number | 0 | 
| labelColSpan | 设置标题的占位宽度,配置值为栅格值,1代表1/24 | number | 4 | 
| labelTextAlign | 表单组件的标题对齐方式 | 'left' | 'right' | 'right' | 
| labelTipsIcon | 表单组件标题提示信息入口图标,当labelTipsTypes取值为 text 或 render 时生效 | string |  -  | 
| labelTipsRender | 表单组件标题提示信息自定义渲染方法,当labelTipsTypes取值为 render 时生效 | (props: IComponentProps) => ReactNode |  -  | 
| labelTipsText | 表单组件标题提示文本信息,当labelTipsTypes取值为 text 时生效 | string |  -  | 
| labelTipsTypes | 表单组件标题提示信息类型设置 | 'none' | |
| notFoundContent | 为空文案 | string |  -  | 
| onChange | 组件值发生改变事件,actionType为触发方式,可用值有: 'itemClick', 'enter', 'change' | ({value: string, actionType:string, item:Data}) => void |  -  | 
| onRemove | 值删除时事件 | (item: DataSource) => void |  -  | 
| onSearch | 搜索框值变化时事件 | (keyword: string) => void |  -  | 
| onVisibleChange | 弹层显示或隐藏时触发事件 | (visible: boolean) => void |  -  | 
| onVisibleChange | 弹层显示或隐藏时触发事件 | (visible: boolean) => void |  -  | 
| placeholder | 表单组件占位提示信息 | string | '请选择' | 
| searchDelay | 搜索延时时间,单位ms | number | 300 | 
| showSearch | 展开后是否能搜索,tag 模式下固定为 true | boolean | true | 
| showSearch | 展开后是否能搜索,tag 模式下固定为 true | boolean | true | 
| size | 表单组件尺寸 | 'medium' | |
| tips | 表单组件描述信息,展示在控件下方 | string |  -  | 
| useDetailValue | 设置value 使用对象类型{label, value} | boolean | false | 
| validation | 表单组件校验设置,具体使用详见表单校验文档 | [] | |
| value | 当前组件默认值 | string[] |  -  | 
| wrapperColOffset | 设置表单组件的偏移位置,设置值为栅格值,1代表1/24 | number | 0 | 
| wrapperColSpan | 设置表单组件的占位宽度,设置值为栅格值,1代表1/24 | number | 0 |