MultiSelectField 下拉多选 - DingTalk Help Center

何时使用

用于替代原生 select，在限定的可选性内进行选择，核心能力是选择。

组件示例

组件属性

属性	说明	类型	默认值
`autoWidth`	下拉菜单是否与选择器对齐	`boolean`	`true`
`behavior`	表单组件显示状态	Behavior	`'NORMAL'`
`dataSource`	设置选项	DataSource[]	`[ { "text": "选项一", "value": "1" }, { "text": "选项二", "value": "2" }, { "text": "选项三", "value": "3" } ]`
`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`	表单组件标题提示信息类型设置	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`	表单组件尺寸	Size	`'medium'`
`tips`	表单组件描述信息，展示在控件下方	`string`	-
`useDetailValue`	设置value 使用对象类型{label, value}	`boolean`	`false`
`validation`	表单组件校验设置，具体使用详见表单校验文档	Validation[]	`[]`
`value`	当前组件默认值	`string[]`	-
`wrapperColOffset`	设置表单组件的偏移位置，设置值为栅格值，1代表1/24	`number`	`0`
`wrapperColSpan`	设置表单组件的占位宽度，设置值为栅格值，1代表1/24	`number`	`0`