基础用法

可过滤

目前是饿了么原生的过滤,对应的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:级联选择器对象
Last Updated:
Contributors: niewk, moujj