vue3-el-cascader-multi

参考el-cascader-multi开发

基于element-plus的级联多选选择器，友好显示下拉箭头，样式与element一致，支持多选与级联选择器的大部分功能。

在线demo

效果预览

install 安装

npm i vue3-el-cascader-multi --save

use 使用

在main.js中写入下面的代码

import elCascaderMulti from "vue3-el-cascader-multi";
VueInstance.use(elCascaderMulti);

接下来，你就可以在页面中使用cascader-multi了

<template>
  <el-cascader-multi v-model="checkList" :options="options" />  
</template>

<script>
import { ref } from 'vue'
export default {
  setup () {
    const checkList = ref([])
    const options = ref([])
    return {
      // 与element级联选择器格式一致
      options,
      checkList
    }
  }
}
</script>

Select Attributes

| 参数 | 说明 | 类型 | 可选值 | 默认值 | | :--------------------: | ------------------------------------------------------------ | :----------------: | :-------------------: | :--------------------------------------------------: | | data | 用于渲染页面的数据(格式与element的级联选择器的数据格式一致) | Array | - | 无 | | value | 默认已选择数据项 | Array | - | 无 | | disabled | 是否禁用 | boolean | - | false | | expand-trigger | 次级菜单的展开方式 | 次级菜单的展开方式 | click / hover | click | | separator | 选项分隔符 | string | - | 横杆'-' | | value-key | 指定选项的值为选项对象的某个属性值 | string | - | value | | label-key | 指定选项标签为选项对象的某个属性值 | string | - | label | | children-key | 指定选项的子选项为选项对象的某个属性值 | string | - | children | | size | 尺寸 | string | medium / small / mini | - | | clearable | 是否支持清空选项 | boolean | - | false | | collapse-tags | 多选时是否将选中值按文字的形式展示 | boolean | - | false | | placeholder | 占位符 | string | - | 请选择 | | filterable | 是否可搜索 | boolean | - | false | | filter-method | 自定义搜索方法 | function | - | 参数为（list，searchText），需要把过滤后的数据return | | no-data-text | 选项为空时显示的文字 | string | - | 无数据 | | popper-class | Select 下拉框的类名 | string | - | - | | reserve-keyword | 多选且可搜索时，是否在选中一个选项后保留当前的搜索关键词 | boolean | - | false | | only-last | 是否只有叶子节点才支持多选 | boolean | - | false | | is-two-dimension-value | 绑定的value是[['level-1','level-2', ''level-3''], ['level-21', 'level-22']]，还是['level-3', 'level-22']这种格式 | boolean | - | true | | show-leaf-label | 是否只显示最后一级的label | boolean | - | false | | check-strictly | 是否严格的遵守父子节点不互相关联 | boolean | - | false |

Select Events

| 事件名称 | 说明 | 回调参数 | | :------------: | ---------------------------------- | :---------------------------: | | change | 选中值发生变化时触发 | 目前的选中值 | | visible-change | 下拉框出现/隐藏时触发 | 出现则为 true，隐藏则为 false | | remove-tag | 移除tag时触发 | 移除的tag值 | | clear | 可清空模式下用户点击清空按钮时触发 | - | | blur | 当 input 失去焦点时触发 | (event: Event) | | focus | 当 input 获得焦点时触发 | (event: Event) |

Select Slots

| 名称 | 说明 | | :----: | ------------ | | prefix | 组件头部内容 | ​