ecm

el-cascader-multi

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

Showing:

Popularity

Downloads/wk

191

GitHub Stars

125

Maintenance

Last Commit

2yrs ago

Contributors

1

Package

Dependencies

3

License

ISC

Type Definitions

Tree-Shakeable

No?

Categories

Readme

el-cascader-multi

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

在线demo

效果预览

multi-cascader

install 安装

npm i el-cascader-multi --save

use 使用

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

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

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

<template>
    <el-cascader-multi v-model="checkList" :data="data"> </el-cascader-multi>
</template>
<script>
    export default {
        data () {
            return {
                data: [], // 与element级联选择器格式一致
                checkList: []
            }
        }
    }
</script>

Select Attributes

参数说明类型可选值默认值
data用于渲染页面的数据(格式与element的级联选择器的数据格式一致)Array-
value默认已选择数据项Array-
disabled是否禁用boolean-false
expand-trigger次级菜单的展开方式次级菜单的展开方式click / hoverclick
separator选项分隔符string-横杆'-'
value-key指定选项的值为选项对象的某个属性值string-value
label-key指定选项标签为选项对象的某个属性值string-label
children-key指定选项的子选项为选项对象的某个属性值string-children
size尺寸stringmedium / 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-classSelect 下拉框的类名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是否只显示最后一级的labelboolean-false

Select Events

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

Select Slots

名称说明
prefix组件头部内容

更新日志

版本:1.1.8

时间:2019-06-21 17:30

内容:

  • fix: 第一级的滚动条问题

版本:1.1.6

时间:2019-05-16 14:50

内容:

  • fix: “程序改变value的值时,选中状态无法更新”
  • feat: “value强制要求为数组,不能为其他值(undefined)”
  • feat: 设置input的width为100%
  • fix: “键盘操作选中/删除选项时,数据框的值变化,但是checkbox没有更新 ”
  • feat: “支持只显示最后一级的label(showLeafLabel)”
  • feat: 删除lodash,功能函数自己写
  • feat: 重新打开浮层时,恢复显示第一层

版本:1.1.4

时间:2019-04-28 16:40

内容:

  • 修复:trigger为hover时无法选中问题

  • 修复:用代码改value没有更新选中状态

  • 修复:清除全部时,没有清掉内容


版本:1.1.2

时间:2019-04-23 11:10

内容:

  • 新增支持“绑定value的格式”:is-two-dimension-value

    表示绑定的value是[['level-1','level-2', ''level-3''], ['level-21', 'level-22']],还是['level-3', 'level-22']这种格式

  • 优化代码eslint报错


版本:1.1.0

时间:2019-04-19 15:10

内容:

  • 修复checkbox无法选中的bug
  • 新增支持“只有叶子节点才能多选”
  • 浮窗样式调整
  • 从dist目录引入编译后的文件

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100