Select
基本用法
透传了element-plus
的所有属性,同时暴露了一个label
,可以通过双向绑定同步更新。custom-label
和custom-value
用于自定义options
中展示和绑定的值的字段。
Select
远程数据源
Select
默认值
Select
展示模式
绑定对象
Select
""
属性
属性 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
customLabel | 选项显示值的字段 | string | - | 'label' |
customValue | 选项绑定值的字段 | string | - | 'value' |
arrayName | 远程数据的字段 | string | - | 'data' |
label / v-model:label | 绑定option的显示值 | string | - | - |
group | 是否需要对options进行分组 | boolean | - | false |
children | option分组的依据,需要与group 一起使用 | boolean | - | false |
defaultValue | 初始化时的默认值 | object / number / string / array | - | - |
immediate | 是否在初始化时请求远程数据 | boolean | - | true |
onlyDisplay | 是否只读(以div包裹) | boolean | - | false |
optionKey | 选项的key值,在绑定值为对象时必填 | string | - | 'value' |
width | 选择框的宽度 | string / number | - | - |
api | 获取远程数据的方法,返回一个promise对象。string 时会通过config-provider 获取api | function | string | - | - |
options | 选项列表 | array | - | - |
itemDisabled | 选项中的禁用项,等价于element-plus 中select-options 的disabled | function(option): boolean | - | - |
方法
方法 | 说明 | 参数 |
---|---|---|
getOptions | 获取当前选择框的选项列表 | - |
getLabel | 获取指定label对应的value | label,默认为当前选中项 |
事件
事件名 | 说明 | 参数 |
---|---|---|
change | 原生change 事件的增强,会同时包含选择对象本身 | val, obj |