简介
下拉单选框组件是一种用于提供可选项列表的 UI 元素,支持从多个选项中选择一项,广泛应用于表单填写、筛选条件设置等场景。

配置项
分类 | 配置 | 示例 | 说明 |
内容 | 选项列表 |
| 可手动或者映射配置,其中手动配置可直接配置每个 currentItem,映射配置需配置数据源(数组),每个 currentItem 包含 label 和 value 这两个属性。 |
默认值 |
| 默认选中选项 | |
占位内容 |
| 占位内容 | |
标签 |
| 表单标签 ,详情参见表单通用属性 | |
交互 | 隐藏 |
| 隐藏,详情参见通用属性 |
搜索 |
| 显示搜索图标 | |
加载 |
| 显示加载动画 | |
禁用 |
| 开启后,组件不可使用 | |
校验 |
| 表单校验,详情参见表单通用属性 | |
样式 | 外边距 |
| 外边距,详情参见通用属性 |
清除按钮 |
| 是否显示清除按钮 | |
形态变体 |
| 各种形态变体,不同形态的可添加的 CSS 样式可能有所不同 | |
空状态文案 |
| 下拉选项列表为空时的文案 | |
CSS 样式 | 圆角 |
| 圆角 |
选项字体大小 |
| 下拉选项字体大小 | |
主题字体大小 |
| 主题字体大小 | |
标签字体大小 |
| 标签字体大小 |
属性与方法
名称 | 类型 | 示例 | 说明 |
value | string |
| 组件的选中内容 |
labelText | string |
| 组件的标签文字内容 |
selectedLabel | string |
| 组件的选中内容的标题 |
disabled | boolean |
| 是否禁用 |
loading | boolean |
| 组件是否处于加载状态 |
data | array |
| 组件选项列表 |
hidden | boolean |
| 组件是否隐藏 |
validationStatus | boolean |
| 组件校验后的状态 |
validationMessage | string |
| 组件校验后的信息 |
blur | func |
| 组件失去焦点 |
focus | func |
| 组件获得焦点 |
validate | func |
| 组件校验 |
setValue | func |
| 设置组件的内容 |
setDisabled | func |
| 设置组件是否禁用 |
setHidden | func |
| 设置组件的隐藏状态 |
clearValue | func |
| 清除组件的 value 值 |
clearHidden | func |
| 清除组件的 hidden 值 |
clearValidate | func |
| 清除组件的校验信息 |
事件回调
配置 | 说明 |
| 组件的值发生改变后触发的事件 |



















