SelectField 下拉选择
何时使用
- 用于替代原生 select,在限定的可选项内进行选择,核心能力是 选择。
组件示例
组件属性
属性 | 说明 | 类型 | 默认值 |
---|---|---|---|
autoWidth | 下拉菜单是否与选择器对齐 | boolean | true |
behavior | 表单组件显示状态 | 'NORMAL' | |
dataSource | 设置选项 |
| |
filter | 本地过滤方法,开启本地过滤时才有 | (value: string, data: DataSource) => boolean | - |
filterLocal | 支持本地过滤,在数据源为远程的时候需要关闭此项 | boolean | - |
hasArrow | 是否有下拉箭头 | boolean | true |
hasBorder | 是否有边框 | boolean | true |
hasClear | 是否有清除按钮 | 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取值为 text 或 render 时生效 | string | - |
labelTipsRender | 表单组件标题提示信息自定义渲染方法,当labelTipsTypes取值为 render 时生效 | (props: IComponentProps) => ReactNode | - |
labelTipsText | 表单组件标题提示文本信息,当labelTipsTypes取值为 text 时生效 | string | - |
labelTipsTypes | 表单组件标题提示信息类型设置 | 'none' | |
notFoundContent | 为空文案 | string | '请输入' |
onChange | 组件值发生改变事件 | (value: string) => void | - |
onRemove | 值删除时事件 | (item: object) => void | - |
onSearch | 搜索框值变化时事件 | (keyword: string) => void | - |
onVisibleChange | 弹层显示或隐藏时触发事件 | (visible: boolean) => void | - |
placeholder | 表单组件占位提示信息 | string | '请选择' |
searchDelay | 搜索延时时间,单位ms | number | 300 |
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 |