使用Vue-TreeSelect组件实现公司-部门-人员级联下拉列表的处理
阅读原文时间:2021年04月21日阅读:1

最近在改造原有Bootstrap开发框架,增加一个Vue&Element前端的时候,发现需要处理一个级联更新的过程,就是选择公司,然后更新部门,选择部门,或者人员列表,选择作为主管的一个实现,不同于Bootstrap使用Select2的插件,这里前端是Vue&Element,那么我们可以选择下拉列表的方式展现,在Element中可以考虑使用Cascader 级联选择器,也可以考虑使用封装Tree 树形控件,或者使用第三方组件Vue-TreeSelect组件。本篇随笔介绍使用Vue-TreeSelect组件实现公司-部门-人员级联下拉列表的处理过程。

1、Vue-TreeSelect组件的使用

在我早期随笔《循序渐进VUE+Element 前端应用开发(8)--- 树列表组件的使用》中也大概介绍了一下Vue-TreeSelect组件,这里我们再来回顾一下它的用法。

GitHub地址:https://github.com/riophae/vue-treeselect

官网地址:https://vue-treeselect.js.org/

NPM安装:

npm install --save @riophae/vue-treeselect

界面代码如下所示。

这里的value就是选中的集合,options则是树列表的节点数据,和Element中的Tree组件一样,options的格式也包含id, lable, children这几个属性。

如果常规的数据提供,我们只要准备这些数据格式给options即可。

如下面的数据格式。

  treedata: \[// 初始化树列表  
    { // 默认数据  
      label: '一级 1',  
      children: \[{  
        label: '二级 1-1'  
      }\]  
    }  
  \]

不过我们一般数据是动态从后端接口中提取的,不是静态的,所以需要使用相应的方法来获取,并设置。

如果是后端接口无法满足特定的属性名称,那么Vue-TreeSelect组件也提供了一个 normalizer 属性方法用来重定义节点属性名称

类似下面的javascript代码

export default {
data: () => ({
value: null,
options: [ {
key: 'a',
name: 'a',
subOptions: [ {
key: 'aa',
name: 'aa',
} ],
} ],
normalizer(node) {
return {
id: node.key,
label: node.name,
children: node.subOptions,
}
},
}),
}

通过normalizer 属性方法可以把数据源的属性映射到树列表中去。有时候我们对于空列表,可能还需要判断为空,并移除这个属性,代码如下所示。

normalizer (node) {
if (node.children && !node.children.length) {
delete node.children
}
return {
id: node.key,
label: node.name,
children: node.children,
}
},

另外,有时候需要在列表值变化的时候,触发级联更新,那么就需要处理@input事件了。

@input="updateValue" />

2、公司-部门-人员级联下拉列表的处理

综合上面的几个特点,我们公司-部门-人员级联下拉列表的处理就需要上面的知识点来处理。

在上面的弹出对话框中,选择所属公司,默认部门,所属经理的操作,级联处理过程效果如下所示。

界面代码如下所示

@input="updateGroupCompany" placeholder="所属公司" />
@input="updateDeptUser" :normalizer="normalizer" placeholder="所属部门" />

如第一项公司列表,我们获取列表后设置options的对象即可。这里面需要定义几个变量 myGroupCompany、myDeptTree、myDeptUser的集合属性。

这里保留了normalizer 映射新属性的做法,不过由于属性名称默认和树控件的属性一致,也可以省略。

在其中更新处理,用到了 @input="updateGroupCompany" 、@input="updateDeptUser" 用于触发更新其他关联内容的事件。

另外一点,我们的新增或者编辑框中v-modal中关联的值,需要设置为null即可。

addForm: {// 新建表单
id: '',
pid: null,
dept_ID: null,
company_ID: null,
…………….
},

在显示弹出对话框,打开新增用户的时候,需要触发获取公司信息列表,如下所示。

showAdd () {  
  this.resetForm('addForm')  
  this.initData() //打开新增窗体的时候,初始化公司列表  
  this.isAdd = true  
},

而其中initData的函数操作如下所示。

async initData () {  
  var param = {}  
  await ou.GetMyGroupCompany(param).then(data => {  
    console.log(data.result)  
    var newTreedata = getJsonTree(data.result, {  
      id: 'id',  
      pid: 'pid',  
      children: 'children',  
      label: 'name'  
    });  
    this.myGroupCompany = newTreedata  
  })  
},

这里调用ou的api进行获取公司信息的操作

import request from '@/utils/request'

import BaseApi from '@/api/base-api'
// 业务类自定义接口实现, 通用的接口已经在BaseApi中定义
class Api extends BaseApi {
// 获取集团公司列表。如果是超级管理员,返回集团+公司节点;如果是公司管理员,返回其公司节点
GetMyGroupCompany(data) {
return request({
url: this.baseurl + 'GetMyGroupCompany',
method: 'get',
params: data
})
}
……….
}

而公司信息触发部门更新,我们用如下函数来处理变化。

async updateGroupCompany (value, instanceId) {  
  // console.log(value + '~' + instanceId)

  this.addForm.dept\_ID = null //置空控件内容  
  if (!this.isEmpty(value)) {  
    var param = { parentId: value }  
    await user.GetDeptJsTreeJson(param).then(data => {  
      this.myDeptTree = data.result  
    })  
  }  
},

由于User的API中 GetDeptJsTreeJson返回的是符合树控件节点属性名称的,因此可以直接赋值给vue-TreeSelect的opition值。

@input="updateDeptUser" :normalizer="normalizer" placeholder="所属部门" />

而部门选择后,则触发部门用户列表的更新,如下代码所示。

async updateDeptUser (value, instanceId) {  
  // console.log(value + '~' + instanceId)  
  this.addForm.pid = null //置空控件内容  
  if (!this.isEmpty(value)) {  
    var param = { deptId: value }  
    await user.GetUserDictJson(param).then(data => {  
      this.myDeptUser = data.result  
    })  
  }  
},

同样,由于由于User的API中 GetUserDictJson 返回的是符合树控件节点属性名称的,因此可以直接赋值给vue-TreeSelect的opition值。

3、特殊处理的内容

前面我们介绍了,如果获取内容和树控件的属性不一致,需要进行转义映射,如下代码所示。

  normalizer (node) {  
    if (node.children && !node.children.length) {  
      delete node.children  
    }  
    return {  
      id: node.id,  
      label: node.label,  
      children: node.children,  
    }  
  },

并在界面代码上指定normalizer处理。

:normalizer="normalizer"

有时候,我们返回的对象集合可能是一个二维列表内容,它本身有id,pid来标识它的层次关系,那么如果我们转换为嵌套列表的话,就可以使用getJsonTree 方法进行转换。

具体操作可以参考:https://blog.csdn.net/unamattin/article/details/77152451

使用的时候,导入这个类方法即可。

import { getJsonTree } from '@/utils/json-tree.js' // 转换二维表数据为树列表数据的辅助类

如果前面介绍的

async initData () {  
  var param = {}  
  await ou.GetMyGroupCompany(param).then(data => {  
    console.log(data.result)  
    var newTreedata = getJsonTree(data.result, {  
      id: 'id',  
      pid: 'pid',  
      children: 'children',  
      label: 'name'  
    });  
    this.myGroupCompany = newTreedata  
  })  
},

如果两个都是嵌套结构的树列表,但是属性名称不同,那么也可以通过map的操作方法,定义一个js函数进行转换即可,转换的代码如下所示。

getTree () { // 树列表数据获取  
  var param = {}  
  user.GetMyDeptJsTreeJson(param).then(data => {  
    // console.log(data)  
    this.treedata = \[\];// 树列表清空  
    var list = data.result  
    if (list) {  
      this.treedata = list  
    }

    //修改另一个Treedata  
    const ass = (data) => {  
      let item = \[\];  
      data.map((list, i) => {  
        let newData = {};  
        newData.id = list.id;  
        newData.label = list.label;  
        newData.children = list.children ? ass(list.children) : null;    //如果还有子集,就再次调用自己  
        //如果列表为空,则移除children  
        if (list.children && !list.children.length) {  
          delete newData.children;  
        }  
        item.push(newData);  
      });  
      return item;  
    }  
    this.selectTreeData = ass(list)  
  });  
},

以上就是数据层次结构相同,属性名称不同的时候,进行转换处理的另外一种方式。

当然,我们定义返回列表数据的时候,如果需要用来绑定在树列表中的,也可以在后端WebAPI进行定义好符合格式的数据,避免在前端额外的代码转换。

    /// <summary>  
    /// 根据用户获取对应人员层次(给树控件显示的下拉列表)(值为ID)  
    /// </summary>  
    /// <param name="deptId">用户所在部门</param>  
    /// <returns></returns>  
    public List<TreeNodeItem> GetUserDictJson(int deptId)  
    {  
        var itemList = new List<TreeNodeItem>();  
        itemList.Insert(0, new TreeNodeItem("-1", "无"));

        var list = BLLFactory<User>.Instance.FindByDept(deptId);  
        foreach (var info in list)  
        {  
            itemList.Add(new TreeNodeItem(info.ID, info.FullName));  
        }

        return itemList;  
    }

其中 TreeNodeItem 类定义了Id, Label,Children的属性,这样前端就可以直接绑定使用了。

以上就是前后端树列表的绑定处理,以及使用Vue-TreeSelect组件实现公司-部门-人员级联下拉列表的功能操作,希望大家不吝赐教。

手机扫一扫

移动阅读更方便

阿里云服务器
腾讯云服务器
七牛云服务器