RemoteSelect
封装接口请求的 Select,此组件一般用于数据量少、搜索条件单一的场景下使用,其他场景请封使用搜索帮助组件来实现。
基础用法
格式化 options 类型
插槽使用
变更之前的回调
自定义添加 options
多选
格式化 Label
禁用 Option
接口请求之后的格式化
Label 模式
RemoteSelect API
RemoteSelect Attributes
名称 | 说明 | 类型 | 默认值 | 必填 |
---|---|---|---|---|
modelValue | 值 | Number, String, Boolean | — | 是 |
label-key | label 使用的 key | String Array | label | — |
value-key | value 使用的 key | String | value | — |
label-mode | 是否开启 label 只读模式,默认跟随全局控制 | Boolean | — | — |
http | 请求的实例 | String | — | 是 |
url | 接口请求 URL,所有接口都是 post 请求 | String | — | 是 |
param | 接口请求参数 | Object | — | — |
method | 请求接口方式 | String | post | — |
append-list | 自定义添加到 options 中的数据 | Array | — | — |
is-storage | 是否本地缓存接口数据(sessionStorage) | Boolean | false | — |
format-option-type | 强制格式化服务器返回的 options 的类型 | String | '' | — |
label-separator | 当label-key 为 Array 类型时可使用此属性来分隔数据 | String | — | |
before-change | 数据变更之前的回调,需要通过返回 Boolean 或者 Promise 对象来指定数据是否可修改,回调参数:(newVal,oldVal) | Function | — | — |
disabled-options | options 不可用的列表 | Array | — | — |
hidden-options | 需要隐藏 options 列表 | Array | — | — |
back-up-value | 当有些场景下拉值中没有选中时,且还需要显示对应的 label 内容时,可使用此属性,需要注意的是:label-mode 为 true,此属性才可用 | any | — | — |
is-clear-by-option-null | 当下拉 options 没有值时,是否清空 value 内容 | Boolean | false | — |
after-request | 接口 请求之后的回调,需要返回一个 list,组件可通过此 list 来格式化数据 | Function | — | — |
RemoteSelect Events
名称 | 说明 | 类型 |
---|---|---|
change | 下拉变更 | Function |
done | 数据加载完成回调 | Function |
blur | 下拉失去焦点 | Function |
RemoteSelect Exposes
方法名 | 说明 | 类型 |
---|---|---|
getOptionsList | 获取下拉选项中的数据 | Function |
RemoteSelect Slots
插槽名 | 说明 |
---|---|
append | 输入框后置内容 |
labelModeValue | 只读模式的展示插槽 |