跳到主要内容

MultiSelectField 下拉多选

何时使用

  • 用于替代原生 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取值为 textrender 时生效

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

Copyright © 2024钉钉(中国)信息技术有限公司和/或其关联公司浙ICP备18037475号-4