Skip to main content

SelectField Dropdown Selection

When to use

  • Used to replace native select, to select from limited options, core capability is 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

Support local filtering, needs to be disabled when data source is remote

boolean

-
hasArrow

Whether there is a dropdown arrow

boolean

true

hasBorder

Whether there is a border

boolean

true

hasClear

Whether there is a clear button

boolean

true

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 text

string

'Please enter'

onChange

Component value change event

(value: string) => void

-
onRemove

Event when value is deleted

(item: object) => void

-
onSearch

Event when search box value changes

(keyword: string) => void

-
onVisibleChange

Event triggered when panel shows or hides

(visible: boolean) => void

-
placeholder

Form component placeholder prompt information

string

'Please select'

searchDelay

Search delay time, unit ms

number

300

showSearch

Whether search is available 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