vue2-tree-select

vue2-tree-select

基于vue2 & element-ui的下拉树组件

在线预览

该组件是由公司的后台集成方案剥离出来的，为了更好的拥抱 vue3，后台集成方案改成了composition-api的语法，由于之前是采用vue-property-decorator的语法，下拉树组件改写成composition-api的写法，成本太高，于是就单独剥离维护。

也因为现在的一些下拉树组件，不太适用于公司业务，或多或少都会存在一些问题。

注意事项

该组件默认不包含vue及element-ui，使用该组件时，项目上必须安装了vue以及element-ui。

导入

npm install vue2-tree-select --save

全局引入

在 main.js 中引入

  import TreeSelect from 'vue2-tree-select'
  import 'vue2-tree-select/dist/css/index.css'

  Vue.use(TreeSelect)

局部引入

  import TreeSelect from 'vue2-tree-select'
  import 'vue2-tree-select/dist/css/index.css'

  components: {
    TreeSelect
  }

使用

<template>
  <div>
    <tree-select
      v-model="value1"
      option-max-width="300px"
      :clearable="true"
      :default-expand-all="false"
      :data="options"
      placeholder="请选择"
      @change="treeSelectChange"
    />
  </div>
</template>

<script>
import TreeSelect from 'vue2-tree-select'

export default {
  components: {
    TreeSelect
  },
  data() {
    return {
      options: []
    }
  },
  created() {
    setTimeout(() => {
      this.options = [
        {
          value: 'zhinan',
          label: '指南',
          children: [
            {
              value: 'shejiyuanze',
              label: '设计原则',
              children: [
                {
                  value: 'yizhi',
                  label: '一致'
                },
                {
                  value: 'fankui',
                  label: '反馈'
                },
                {
                  value: 'xiaolv',
                  label: '效率'
                },
                {
                  value: 'kekong',
                  label: '可控'
                }
              ]
            },
            {
              value: 'daohang',
              label: '导航',
              children: [
                {
                  value: 'cexiangdaohang',
                  label: '侧向导航'
                },
                {
                  value: 'dingbudaohang',
                  label: '顶部导航'
                }
              ]
            }
          ]
        },
        {
          value: 'zujian',
          label: '组件',
          children: [
            {
              value: 'basic',
              label: 'Basic',
              children: [
                {
                  value: 'layout',
                  label: 'Layout 布局'
                },
                {
                  value: 'color',
                  label: 'Color 色彩'
                },
                {
                  value: 'typography',
                  label: 'Typography 字体'
                },
                {
                  value: 'icon',
                  label: 'Icon 图标'
                },
                {
                  value: 'button',
                  label: 'Button 按钮'
                }
              ]
            },
            {
              value: 'formWrap',
              label: 'Form',
              children: [
                {
                  value: 'radio',
                  label: 'Radio 单选框'
                },
                {
                  value: 'checkbox',
                  label: 'Checkbox 多选框'
                },
                {
                  value: 'input',
                  label: 'Input 输入框'
                },
                {
                  value: 'input-number',
                  label: 'InputNumber 计数器'
                },
                {
                  value: 'select',
                  label: 'Select 选择器'
                },
                {
                  value: 'cascader',
                  label: 'Cascader 级联选择器'
                },
                {
                  value: 'switch',
                  label: 'Switch 开关'
                },
                {
                  value: 'slider',
                  label: 'Slider 滑块'
                },
                {
                  value: 'time-picker',
                  label: 'TimePicker 时间选择器'
                },
                {
                  value: 'date-picker',
                  label: 'DatePicker 日期选择器'
                },
                {
                  value: 'datetime-picker',
                  label: 'DateTimePicker 日期时间选择器'
                },
                {
                  value: 'upload',
                  label: 'Upload 上传'
                },
                {
                  value: 'rate',
                  label: 'Rate 评分'
                },
                {
                  value: 'form',
                  label: 'Form 表单'
                }
              ]
            },
            {
              value: 'data',
              label: 'Data',
              children: [
                {
                  value: 'table',
                  label: 'Table 表格'
                },
                {
                  value: 'tag',
                  label: 'Tag 标签'
                },
                {
                  value: 'progress',
                  label: 'Progress 进度条'
                },
                {
                  value: 'tree',
                  label: 'Tree 树形控件'
                },
                {
                  value: 'pagination',
                  label: 'Pagination 分页'
                },
                {
                  value: 'badge',
                  label: 'Badge 标记'
                }
              ]
            },
            {
              value: 'notice',
              label: 'Notice',
              children: [
                {
                  value: 'alert',
                  label: 'Alert 警告'
                },
                {
                  value: 'loading',
                  label: 'Loading 加载'
                },
                {
                  value: 'message',
                  label: 'Message 消息提示'
                },
                {
                  value: 'message-box',
                  label: 'MessageBox 弹框'
                },
                {
                  value: 'notification',
                  label: 'Notification 通知'
                }
              ]
            },
            {
              value: 'navigation',
              label: 'Navigation',
              children: [
                {
                  value: 'menu',
                  label: 'NavMenu 导航菜单'
                },
                {
                  value: 'tabs',
                  label: 'Tabs 标签页'
                },
                {
                  value: 'breadcrumb',
                  label: 'Breadcrumb 面包屑'
                },
                {
                  value: 'dropdown',
                  label: 'Dropdown 下拉菜单'
                },
                {
                  value: 'steps',
                  label: 'Steps 步骤条'
                }
              ]
            },
            {
              value: 'others',
              label: 'Others',
              children: [
                {
                  value: 'dialog',
                  label: 'Dialog 对话框'
                },
                {
                  value: 'tooltip',
                  label: 'Tooltip 文字提示'
                },
                {
                  value: 'popover',
                  label: 'Popover 弹出框'
                },
                {
                  value: 'card',
                  label: 'Card 卡片'
                },
                {
                  value: 'carousel',
                  label: 'Carousel 走马灯'
                },
                {
                  value: 'collapse',
                  label: 'Collapse 折叠面板'
                }
              ]
            }
          ]
        },
        {
          value: 'ziyuan',
          label: '资源',
          children: [
            {
              value: 'axure',
              label: 'Axure Components'
            },
            {
              value: 'sketch',
              label: 'Sketch Templates'
            },
            {
              value: 'jiaohu',
              label: '组件交互文档'
            }
          ]
        }
      ]
    }, 2000)
  },
  methods: {
    treeSelectChange(val) {
      console.log(val)
    }
  }
}
</script>

<style></style>

Attributes

属性	说明	类型	可选值	默认值
data	渲染的数组	array	—	[]
id	标签 Id	string	—	—
name	标签 name	string	—	—
value	v-model 值	string/number/array	—	—
multiple	是否多选	boolean	true/false	false
clearable	是否可以清空选项	boolean	true/false	false
defaultExpandAll	是否展开所有	boolean	true/false	false
size	输入框尺寸	string	medium/small/mini	—
props	配置选项，详见下表	object	—	—
placeholder	提示语	string	—	请选择
nodeKey	唯一标识	string/number/array	—	value
lazy	是否懒加载	boolean	true/false	false
load	加载子树数据的方法，仅当 lazy 属性为 true 时生效	function	—	—
showCheckbox	是否显示多选框	boolean	true/false	false
checkStrictly	在显示复选框的情况下，是否严格的遵循父子不互相关联的做法，默认为 false	boolean	true/false	false
expandOnClickNode	是否在点击节点的时候展开或者收缩节点， 默认值为 true，如果为 false，则只有点箭头图标的时候才会展开或者收缩节点。	boolean	true/false	true
filterable	是否可搜索	boolean	true/false	false
filterMethod	搜索方法，当 filterable 为 true 时生效	function	—	—
collapseTags	多选时是否将选中值按文字的形式展示	boolean	true/false	false
collapseTagsMaxNum	多选时将选中值按文字的形式展示最大个数	number	—	1
tooltipEffect	tooltip 默认提供的主题	string	dark/light	dark
optionMaxWidth	下拉项最大宽度	string	—	—
renderContent	自定义渲染方法	function	—	—

Props

属性	说明	类型	可选值	默认值
label	指定节点标签为节点对象的某个属性值	string, function(data, node)	—	—
children	指定子树为节点对象的某个属性值	string	—	—
disabled	指定节点选择框是否禁用为节点对象的某个属性值	boolean, function(data, node)	—	—
isLeaf	指定节点是否为叶子节点，仅在指定了 lazy 属性的情况下生效	boolean, function(data, node)	—	—

Events

事件名称	说明	回调参数
change	值改变的后的回到	value