/wl-vue-select

用于vue框架的树形下拉框及带全选的普通下拉框。 Tree drop-down box for vue framework and ordinary drop-down box with select all

Primary LanguageVueMIT LicenseMIT

wl-vue-select

简介

用于vue框架的树形下拉框及带全选的普通下拉框。
Tree drop-down box for vue framework and ordinary drop-down box with select all.
本组件提供全选下拉框和树形下拉框功能。
wlVueSelect这是一个基于 elementUi 的 el-select 组件的二次封装的下拉框,提供了全选功能和默认选中功能;
wlTreeSelect这是一个基于 elementUi 的 el-tree 组件的二次封装的下拉框,提供了树形数据支持和默认选中功能;
因这两个需求非常普遍,所以作为一个独立插件发布。
el-select

快速上手

npm i wl-tree-select --save

npm i wl-vue-select -S

使用

import wl from "wl-vue-select";`
import "wl-vue-select/lib/wl-vue-select.css"
Vue.use(wl);
    <wlVueSelect
      v-model="value"
      :props="props"
      :data="data"
      multiple
      default-select
    ></wlVueSelect>
    <p>----------分割线------------</p>
    <wlTreeSelect
      leaf
      width="240"
      checkbox
      :data="treeData"
      @change="hindleChanged"
      v-model="selected"
    ></wlTreeSelect>
data() {
    return {
      value: [], // 选中值
      data: [
        {
          id: 1,
          name: "海边"
        },
        {
          id: 2,
          name: "森林"
        },
        {
          id: 3,
          name: "草原"
        },
        {
          id: 4,
          name: "古城"
        }
      ], // 数据
      props: {
        label: "name",
        value: "id"
      }, // 配置
      treeData: [
        {
          id: "love",
          name: "所有和你走过的风光",
          children: [
            {
              id: 1,
              name: "海边",
              children: [
                {
                  id: 5,
                  name: "蓬莱",
                }
              ]
            },
            {
              id: 2,
              name: "森林"
            },
            {
              id: 3,
              name: "草原"
            },
            {
              id: 4,
              name: "古城"
            }
          ]
        }
      ],
      selected: [ "1" ]// 树下拉框选中数据
    };
  },
  methods: {
    hindleChanged(val){
      console.log(val,2)
      console.log(this.selected)
    }
  },

文档

序号 参数 说明 类型 可选值 默认值
1 data options 可选列表数据 Array - -
2 props 配置项:显示名字的 label 字段和绑定值的 value 字段 Object - { label: "label", value: "value" }
3 showTotal 当可选项大于多少个时显示全选选项 Number - 1
4 defaultSelect 是否启用默认选中,如果开启全部时选中全部,无全部时选中第一个。(开启此功能请不要给 v-model 赋初始值) Boolean - false
5 其他 其他 el-select 提供的参数 - - -
6 nodeKey 使用树形下拉框时,必须使用 key 来解析数据 String - id
7 selected[废弃] 使用树形下拉框时,绑定选中数据【现改为v-model 】 String-Number-Array-Object - -
8 checkbox 使用树形下拉框时,是否开启多选 Boolean - false
9 width 使用树形下拉框时宽度,默认单位 px String-Number - 240
10 leaf 树形下拉框时,是否只可选叶子节点 Boolean - false
11 trigger 树形下拉框时,触发方式 String click/focus/hover/manual click
12 v-model 普通及树形下拉框绑定值,用法与普通表单元素相同 String-Number-Array-Object - -
13 disabled 是否禁用下拉框 Boolean - false
14 nowrap 是否不允许多行显示,true则只显示一行 Boolean - false
15 noCheckedClose 多选时,是否全部取消选中时,自动关闭选项区域 Boolean - false
16 size 尺寸,用法同elementui String - medium

版本记录

0.4.6 优化树形下拉框,使size属性生效

0.4.5 优化树形下拉框placeholder,增加参数管理全部取消选中时收起选项

0.4.2 优化树形下拉框,增加是否不允许多行显示字段

0.4.1 优化树形下拉框,增加禁用字段

0.3.9 优化树形下拉框默认传进来的选中数据为复杂型数组时,提取id;

0.3.8 修复树形下拉框多选时,数据为空时只清理了显示区未清理树chekcbox的问题

0.3.7 修改树形下拉框单选时默然选中是否只选子节点根据leaf字段

0.3.5 修复树形下拉框单选时的默认选择的缺陷【绑定值为数组时】

0.3.4 修复树形下拉框el-tree默认选中字段为空,getNodes方法还能获取到上次值的问题,更新rademe示例

0.3.3 修复树形下拉框开启多选时无限循环的问题,优化多选时根据leaf字段来确定是否只返回叶子节点

0.3.2 优化树形下拉框横向超出不显示问题

0.3.0 优化树形下拉框,增加触发显示方式字段

0.2.7 优化树形下拉框单选时,可选层级,并增加leaf参数设置是否只可选择叶子节点,优化树形单选时,默认选中为object类型时的高亮效果

0.2.5 优化树形下拉框筛选算法,优化树形下拉框在可选项太长时增加滚动效果

0.2.4 修复showTotal大于data长度时,出现了empty的问题

0.2.3 更新示例

0.2.2 增加树形下拉框

0.1.2 更新算法,全选转单选时无需手动取消全选选项

0.1.0 初次发布,在基于 el-select 上增加全选和默认选中功能