目录

需求描述

一、实现动态加载选项

二、数据回显问题

三、额外需求:点击单选框选中节点时,同时加载下一级选项

四、额外需求:点击label标签时,能够直接选中该节点

网上看了一圈,很多文章解决方案中选项层级是固定死3层而不是随意多少层都可以的,还有很多讲不清楚的,总结了一下踩坑经验,希望对大家有用。

需求描述

前端使用el-cascader组件来实现一个层级选择器,可以支持单选或多选节点,节点的层级关系和名称都由后端来定义和控制,前端根据后端提供的数据来渲染。

实现该效果,需要后端配合需要提供2个接口:

1.接口1:前端传入指定节点ID,后端返回该节点的下一层所有节点ID信息列表。

2.接口2:前端传入指定节点ID,后端返回该节点从顶部父节点至该节点的所有路径节点ID列表。

级联选择器 el-cascader 使用

最关键的只有这两项:v-model绑定值 和 props 配置项

一、实现动态加载选项

常用props配置:

动态加载选项不需要 : options 配置,一般静态的才使用options配置。

  • checkStrictly:true是否可以选择树干节点作为选项(根据实际需求选择)
  • lazy:true是否动态加载节点(当然,这正是我们需要的)
  • lazyLoad: this.loadTreeNode 指定加载节点的方法,这里我定义的名字叫loadTreeNode
  • multiple: true 是否支持多选
props: {checkStrictly: true, //是否可以选择树干节点作为选项lazy: true, // 是否动态加载子节点// lazyLoad加载动态数据的方法(仅在 lazy 为 true 时有效)lazyLoad: this.loadTreeNode,},

loadTreeNode ,自定义的加载节点的方法(具体逻辑看注释基本就能看明白):

//加载树节点首次加载页面时就会执行一次,之后每选中一个节点也会调用,来渲染下一层loadTreeNode(node, resolve) {console.log(node);// 首次加载时 node为{root:true,level:0}// node 节点数据获取node的level字段的值const { level } = node;//下一层节点const nodes = [];//如果有子节点 或者 为根节点(即首次进入level为0)//也有人写成 node.level == 0 作用是一样的 if (node.hasChildren || node.root) {// 0 代表第一次请求let nodeId = level == 0 ? null : node.value;//这里setTimeout的目的是 显示加载动画setTimeout(() => {//调用后端接口 获得返回数据let ret = this.api(nodeId);if (ret && ret.succeeded) {//ret.reulst为后端返回的数据let nodes = ret.result;// 回调渲染下一层resolve(nodes);} else {//后端报错 弹窗提示失败this.$message({type: "error",message: "部门层级加载失败,请联系管理员!",});}}, 1);} else {//如果没有子节点就不发起请求,直接渲染,也避免了点击叶子节点仍然有加载动画的问题resolve(nodes);}},

叶子节点 —— 意思是:没有子节点的节点,它就是最底层。

其中 this.api 指的是调用后端提供的第一个接口

接口1:前端传入指定节点ID,返回该节点的下一层所有节点ID信息列表(当nodeId为空时,返回第一层节点)。

返回的数据需要是一个列表,后端返回的数据 List 大概长这样:

JAVA后端的节点定义可参考:

@Data@AllArgsConstructor@NoArgsConstructorpublic class UserGroupTreeNode {/** * 节点值 */private String value;/** * 节点标签 */private String label;/** * 是否为叶子节点(即没有子节点)true 没有子节点 false 有子节点 */private Boolean leaf;}

其中value即为节点的ID,label为展示的名称,leaf为是否含有子节点,Bool类型。

value,label,leaf 变量名务必保持一致,否则前端拿到数据之后,得自己转成这个变量名。

到这里,这个组件已经可以正常使用了。

二、数据回显问题

问题描述:上面已经解决了层级选择器的数据渲染问题,用来做查询或者新增都已经够了。但是当我们需要修改数据时,点击修改打开的弹窗中对应的字段无法正确回显。

理想情况:它应该逐层展示,并且点击它想要修改时,层级选择器组件应该默认选中绑定的值。

实际情况:打开后要重新一层一层去选择,这显然不符合实际需求。

解决思路:

1.首先,我们在新增数据时,级联选择器v-model绑定的参数是一个列表,

例如:我们选中【sub-1-2-3】这个节点时,

它实际绑定的值是:[“root”,”sub-1″,”sub-1-2″,”sub-1-2-3″]。

而后端实际保存的值一般都是选中节点的id,即”sub-1-2-3″。

2.已知el-cascader组件绑定的值是一个列表,所以当我们需要正确回显,也需要给它赋值一个数组才行。

所以我们需要与后端约定的第二个接口

接口2:前端传入指定节点ID,后端返回该节点从顶部父节点至该节点的所有路径节点ID列表。

格式如下图,需要特别注意的是顺序需要和实际节点层级顺序一致!

这里返回的是节点的ID数组列表,

前端拿到它后,直接赋值给 el-cascader 组件v-model绑定的变量即可。

然后就可以正常显示啦!

这样就处理完成了,但是还有一个问题,应该算是element-ui的BUG。

情景描述:只有在首次加载页面后,编辑数据A时,数据A回显一切正常,关闭弹窗,再编辑其他数据,此时的修改弹窗中el-cascader 组件文本框中,回显都为空,不再正常回显了。

原因是:

首次编辑数据时,el-cascader会根据v-model绑定的参数值,

比如[“1″,”2″,”3″,”4”] 这个数组

逐层调用lazyLoad获取整个树结构,

即:依次将 “1”,”2″,”3″,”4″作为参数,调用lazyLoad,分别渲染头结点”1″,头结点下一层,ID为节点”2″的下一层,以及下一层中,ID为“3”的下一层,最后整个合并起来。

整个过程是组件自动完成的。

所以能正确回显。

但是当关闭编辑弹窗,再编辑其他数据时,虽然el-cascader 组件v-model绑定的参数值发生了变化,但是没有再触发调用lazyLoad方法再逐层请求后端渲染整个结构树。

目前网上的解决办法总体有两种思路:

  • 1.给el-cascader组件绑定 options选项,根据v-model绑定参数的值,也就是数组的值,手动调用后端接口,逐个获取下一层的选项,拼接成树结构,将生成树结构给 el-cascader 使用,这样就能正确回显。这种思路其实本质上就是自己写lazyLoad的逻辑,放弃使用官方提供的lazyLoad方法(不推荐)。
  • 2.将el-cascader 组件 重新渲染一次,既然首次加载的时候能正确调用lazyLoad,那每次都重新来,都当成首次加载就好了,这就是用v-if解决的思路(推荐)。

方法一实现起来太复杂,方法二简单很多,推荐使用方法二。

另外希望element-ui官方能修复这个问题,这样我们也不用折腾了。

方法二:

给el-cascader组件 加上 v-if=”editCascaderVisible”

然后在editRow,即打开修改弹窗方法时,手动控制它刷新一次:

关键代码:

this.editCascaderVisible = false;// 这里搞个定时器重新载入一下组件就可以触发组件拉取数据setTimeout(() => {this.editCascaderVisible = true;}, 1);

完整代码:

editRow(rowData) {this.editCascaderVisible = false;// 这里搞个定时器重新载入一下组件就可以触发组件拉取数据setTimeout(() => {this.editCascaderVisible = true;}, 1);this.IdList= [];//在编辑的时候等到DOM更新完成再赋值this.$nextTick(() => {//将选中数据的值 赋值给表单this.dataForm = Object.assign({}, rowData);});//调用后端接口,获取自顶向下逐个层级ID的列表这里我el-cascader绑定的变量是IdListthis.IdList= this.api_getIdList(rowData.groupId);//打开修改弹窗this.dialogVisible = true;}

这样每次点击编辑的时候,就都能正确回显了。

三、额外需求:点击单选框选中节点时,同时加载下一级选项

情景描述:当我们直接点击【万州支行】标签左侧的单选框时,只执行了选中操作,此时不会加载【万州支行】的下属机构,但是实际使用时,我们在点击选中时,又想看到下一级的机构选项怎么办?

因为我们使用的是lazyLoad模式,点击单选框选中时,不会触发加载下一级选项,如图:

问题解决思路:

已知:当我们点击选项文字标签即label时,组件就会触发加载下一级节点。

所以当我们选中节点时,可以借用change方法来手动加载下一级节点。

选中的节点发生变化时,会触发change方法,此时我们自定义一个方法,来模拟点击文字标签,即Label,即可解决。由于在页面布局上,单选框radio的同级下一个元素,就是label,所以用dom去获取它的同级下一个元素,再手动执行一次click事件即可。

实现代码:

//处理单选点击事件handleChange(e) {this.$nextTick(() => {const dom = document.getElementsByClassName("el-radio is-checked");//这里我把dom打出来看了 最后一个选项才是我选中的节点 即[length-1] 有的博主写的是 第一个元素 即[0] 大家自行尝试let radioDom = dom[dom.length - 1];const brother = radioDom.nextElementSibling;brother.click();});},

四、额外需求:点击label标签时,能够直接选中该节点

情景描述:单选的情况下,要选中某个节点选项,需要点击radio按钮,而radio本身很小,所以它的的可点击区域也很小,想直接点中它,还得眼神好一点才行,不太方便,如果能点击标签页直接选中它就好了。

解决思路:既然点击区域很小,那就用css把它本体放大就好了。把单选框的范围放大到整个标签范围,点击标签相当于点单选框。

实现代码:

/*单选的级联选择器,点击标签页就可以选中*/.el-cascader-menu .el-radio {display: table;vertical-align: middle;width: 100%;height: 100%;position: absolute;box-sizing: border-box;margin-left: -25px;padding-left: 15px;margin-top: 6px;}.el-cascader-menu .el-radio .el-radio__input {display: table-cell;vertical-align: middle;}

附(记录一下,可以不看了):

记录一下解决过程中对el-cascader 组件的认识:

加入ref,可以使用

this.$refs.editCascader.panel

获取到el-cascader 对象

可以使用

this.$refs.editCascader.panel.lazyLoad(cqbankNode);

主动调用lazyLoad绑定的方法,传入的节点要有chidren字段,或者直接取自

let cqbankNode = this.$refs.editCascader.panel.menus[0][0];

menus是菜单项

menus[0]即第一个下拉框列表,

menus[1]即第二个下拉框列表,可以通过修改menus,修改下拉框展示列。

但是根据 menus[0][0] 去获取,有时候节点children为空,可能应该换一个属性去获取,这个思路应该也能做,当时是取值属性来源错了,为空就写不下去了就换思路了。