Skip to main content

MultiSelectField Dropdown Multi-select

When to Use

  • Used to replace native select, making selections within limited options, with the core capability being selection.

Component Example

Component Properties

属性说明类型默认值
autoWidth

Whether dropdown menu aligns with selector

boolean

true

behavior

表单组件显示状态

Behavior

'NORMAL'

dataSource

Set options

DataSource[]

[
{
  "text": "Option 1",
  "value": "1"
},
{
  "text": "Option 2",
  "value": "2"
},
{
  "text": "Option 3",
  "value": "3"
}
]
    
filter

Local filter method, only available when local filtering is enabled

(value: string[], data: DataSource) => boolean

-
filterLocal

Need to disable this when data source is remote, returns a Boolean value to determine whether to retain

boolean

true

hasArrow

Set whether to show dropdown arrow

boolean

true

hasBorder

Whether to have border

boolean

true

hasSelectAll

Whether to have select all functionality

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取值为 textrender 时生效

string

-
labelTipsRender

表单组件标题提示信息自定义渲染方法,当labelTipsTypes取值为 render 时生效

(props: IComponentProps) => ReactNode

-
labelTipsText

表单组件标题提示文本信息,当labelTipsTypes取值为 text 时生效

string

-
labelTipsTypes

表单组件标题提示信息类型设置

LabelTipsTypes

'none'

notFoundContent

Empty content text

string

-
onChange

Component value change event, actionType is the trigger method, available values are: 'itemClick', 'enter', 'change'

({value: string, actionType:string, item:Data}) => void

-
onRemove

Event when value is deleted

(item: DataSource) => void

-
onSearch

Event when search box value changes

(keyword: string) => void

-
onVisibleChange

Event triggered when popup layer is shown or hidden

(visible: boolean) => void

-
onVisibleChange

Event triggered when popup layer is shown or hidden

(visible: boolean) => void

-
placeholder

Form component placeholder hint message

string

'Please Select'

searchDelay

Search delay time, unit in ms

number

300

showSearch

Whether to enable search after expansion, fixed to true in tag mode

boolean

true

showSearch

Whether to enable search after expansion, fixed to true in tag mode

boolean

true

size

表单组件尺寸

Size

'medium'

tips

表单组件描述信息,展示在控件下方

string

-
useDetailValue

Set value to use object type {label, value}

boolean

false

validation

表单组件校验设置,具体使用详见表单校验文档

Validation[]

[]

value

Current component default value

string[]

-
wrapperColOffset

设置表单组件的偏移位置,设置值为栅格值,1代表1/24

number

0

wrapperColSpan

设置表单组件的占位宽度,设置值为栅格值,1代表1/24

number

0

This doc is generated using machine translation. Any discrepancies or differences created in the translation are not binding and have no legal effect for compliance or enforcement purposes.
© 2014–2025 DingTalk Technology Co., Ltd