基础用法
可过滤
目前是饿了么原生的过滤,对应的keyword高亮、输入框聚焦选中值变成placeholder、多选后清空查询文字等细节待完善。
级联选择器 属性
属性名 | 说明 | 类型 | 默认值 |
---|
model-value / v-model | 绑定值 | string \ Array | — |
options | 选择器的选项列表,如果有api请求会覆盖掉这个值 | Array | — |
props | 配置选项,如果有api请求mapObj内参数会修改这个值 | Object | — |
api | 请求选项列表的接口 | string | — |
serviceMethod | 请求选项列表的请求方式 | string | —,没有默认值,但是会拿去注册组件时的serviceOptions.defaultMethod,默认是post |
serviceParams | 请求选项列表的请求参数 | Object | — |
mapObj | 请求选项列表需要进行映射的对象,下面会具体列出 | Object | — |
其他级联选择器的属性请参考element-plusopen in new window. 另外查询组件通用属性请查看查询组件通用.
mapObj字段说明
字段名 | 说明 |
---|
list | 后端返回对象里作为options数据的字段,没有就取整个返回的数据 |
label | 后端返回对象里作为props配置中label的字段,默认label |
value | 后端返回对象里作为props配置中value的字段,默认value |
children | 后端返回对象里作为props配置中children的字段,默认children |
cbs 回调函数说明
回调函数名 | 说明 | 参数 |
---|
beforeSearch | 在通过api查询options之前执行的回调函数,若返回 false 或者返回被 reject 的 Promise,则阻止切换。 | (params) => res, params :当前请求参数, res : 有正常返回会作为实际的请求参数 |
afterSearch | 在通过api查询options之后执行的回调函数 | (list, options, modelValue) => {}. list :请求到的列表, options : 绑定到下拉框里的原始对象,modelValue :选中绑定值的原始对象 |
defineSearch | 自定义的请求方法,有这个方法就不会做默认的请求 | (options, modelValue) => {}. options : 绑定到下拉框里的原始对象,modelValue :选中绑定值的原始对象 |
filterCallback | 过滤的回调函数,若返回 false 或者返回被 reject 的 Promise,则阻止切换。正常返回数组,则作为过滤结果展示 | (keyword, options, modelValue) => arr.keyword :过滤的keyword, options : 所有选项,modelValue :选中绑定值的原始对象 |
change | 选中值改变会触发执行的回调函数 | (data, cascaderRef) => {} data 通过级联选择器的getCheckedNodes获取到的当前选中项的数据组成的数组,cascaderRef :级联选择器对象 |