# 使用场景
基于 a-select 封装的下拉列表组件,当下拉的数据是通过接口获取时使用,将接口函数传递到 loadData 参数,可以减少一些代码量。其他场景还是建议使用 a-select。
# 使用示例
基础使用
支持父组件 v-model 传入,选择之后实时展示
传入一个对象:{"key":"0"}
传入一个字符串:"1"
loadData 支持直接返回一个数组:"0"
结合 FormModel 使用
支持在 FormModel 中使用,支持表单校验。
扩展功能
支持 a-select 自带的属性和事件,但建议只是用到 loadData 场景的时候再使用该组件,其他情况用 a-select,该组件只是对 a-select 组件的补充。
当前选项:["0","1"]
# API
Attributes
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
loadData | 加载数据的方法,支持 Promise 对象和普通函数,也支持传递一个数组作为下拉列表 | Promise | Function | Array | -- | -- |
value(v-model) | 指定当前选中的条目 | String | String[] | Number | Number[] | Object | -- | {} |
fieldKey | 自定义 options 中 value 和 label 的字段取值,不支持只配置 value 或 value,需要两个字段一起设置 | Object | -- | {value: 'value', label: 'label'} |
filterOption | 是否根据输入项进行筛选。当其为一个函数时,会接收 inputValue option 两个参数,当 option 符合筛选条件时,应返回 true,反之则返回 false,默认内置了对 label 的搜索匹配 | Function | Boolean | -- | (input, option) => option.label.indexOf(input) !== -1 |
Events
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
change | 同 a-select 的 change,但 option 的返回值增加了 option.data.attrs.dataOption 字段用来获取当前选中下拉的所有字段信息 | Function | Function | function(value, option: Option | Array<Option>) |
其他更多 API,请移步传送门 (opens new window)