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 | 只读模式的展示插槽 |
Setaria Business Framework