Multi-Cascader

概述

由于elementUI 的级联选择器暂不支持多选，因此基于elementUI开发此组件，所有的样式class都是使用 elementUI 原样式，基本可无副作用的引入项目使用，有任何问题欢迎发布 issue，我会在看到第一时间回复大家。 如果觉得组件还不错的话 不要吝啬你的 star 哦~

• 查看demo
• 安装
• 文档

2020-03-03 更新

**TIP：**当前包基于 elementUI 2.4.11 开发，安装之后很有可能出现与使用的版本不兼容的情况，由于版本更新频繁加上搬砖任务繁重，没法为每个版本做兼容。强烈建议大家直接Copy源码食用，可随意做样式修改，源码结构比较简单，修改无需太多成本 : )

• 修复Demo中样式错乱的问题 #78 #69
• 在v2.2.5之后将组件CSS打包到输出js文件中，使用时无需单独引用包中CSS文件

2019-04-18 更新

• 由于IE的兼容性问题比较复杂，需要结合 babel 相关插件实现，并且打包出来体积会比较大，所以 dist 文件中的包没有兼容 IE，需要兼容 IE 可以拷贝源码放入具备兼容插件的环境中打包实现
• 修复动态加载中错误警告导致子集无法展开的问题 #41 #47
• 修复选项面板宽度无法自定义/自适应问题 #44 #46
• 新增panelWidth<Number | String>选项控制层级面板宽度。
  • Number - 默认 180
  • String - 只可设置唯一值 auto，面板会根据内容自动撑开。但不建议这么做，因为数据的长度是未知的。
• 采用了umd打包方式，项目中需要单独引用 import "ele-multi-cascader/dist/cascader.css"。

2019-03-27 更新

• 新增 clearable 选项，控制清除全部已选项，同 elementUI #30
• 新增 popperClass 选项，自定义弹出层 class，同 elementUI #30
• 新增 remove-tag clear事件，同 elementUI

2019-03-22 更新

• 支持动态加载子项 #17 Function(parentItem<Object>): Promise: [] 详情查看Attributes文档
• 支持通过设置 label-key ， children-key ， value-key 来设置 label、value、children 字段

2019-01-16 更新

• 修复 #11 BUG
• 新增 collapse-tags 选项，控制输入框标签折叠，同 elementUI
• 新增 show-all-levels 选项，控制是否展示所有层级，同 elementUI
• 新增 output-level-value 选项，控制输出value 是否为全部层级
• 新增 separator 选项，控制层级分隔符Note：会对输出value和展示标签同时起作用
• 新增 no-data-text 选项，修改无数据文字

2019-01-14 更新

• 支持选中子项 selectChildren #4
• 支持 @clickItem 事件，返回当前点击项，触发时机先于 @change
• 修复 v-model 只能初始化一次的BUG #5

安装

可直接复制源码

推荐使用npm安装：

npm install ele-multi-cascader

使用

// main.js
import EleMultiCascader from "ele-multi-cascader"
// 从2.2.5后不需要单独引用CSS
import "ele-multi-cascader/dist/cascader.css"

Vue.use(Element)
Vue.use(EleMultiCascader)

Attributes

Item Attributes

事件

示例

<!-- *.vue -->
<template>
	<el-form label-width="80px" ref="form" :model="form" :rules="rules" label-position="left">
        <el-form-item label="ISP: " prop="isp">
            <ele-multi-cascader
              :options="options"
              v-model="form.isp"
              placeholder="选择运营商"
              @change="ispChange"
              >
            </ele-multi-cascader>
        </el-form-item>
        <el-form-item>
            <el-button type="primary" @click="submit">测试提交</el-button>
        </el-form-item>
    </el-form>
</template>

<script>

export default {
  data() {
    return {
      options: [],
      outputs: {
        values: [],
        items: []
      },
      rules: {
        isp: [
          {
            required: true,
            trigger: "change",
            validator(rule, val, cb) {
              if (val.length === 0) {
                cb(new Error("请选择运营商"));
              } else {
                cb();
              }
            }
          }
        ]
      },
      form: {
        isp: []
      }
    };
  },
  methods: {
    ispChange(values, items) {
      this.outputs.values = values;
      this.outputs.items = items;
    },
    submit() {
      this.$refs.form.validate(valid => {
        if (valid) {
          this.$message({
            message: "测试通过",
            type: "success"
          });
        }
      });
    }
  }
};
</script>

依赖

- Vue
- ElementUI