el-cascader数据渲染及回显至页面(以及踩坑历程+解决)

本文记录了在使用el-cascader组件时遇到的两个主要问题及其解决方案:1. 当最小子集的children为空数组时,如何避免无效渲染;2. 数据回显时如何正确设置props属性以确保数据正常显示。同时提供了处理源数据的两种方法,并强调了回显数据的格式要求。最后提到了通过getCheckedNodes方法获取选中数据的备选方案。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

第一次使用el-cascader就把坑踩了个遍,写个记录,也希望能够帮助到同为小猿的你们。

下面是我写的一个还原项目的例子

Bug1  首先是最小子集仍然有children,但是children为空数组,el-cascader渲染时,发现有children所以继续渲染了,只是没数据

 

  <el-cascader
          :props="defaultParams"
          :options="options"
          v-model="form.selectedOptions"
        >
        </el-cascader>


//option是要选择的数据

 options: [
        {
          id: "1",
          name: "水果",
          level: "1",
          pid: "0",
          status: "1",
          sub: [
            {
              id: "4",
              name: "苹果",
              level: "2",
              pid: "1",
              status: "1",
              sub: [
                {
                  id: "41",
                  name: "红富士",
                  level: "2",
                  pid: "1",
                  status: "1",
                  sub: [],
                },
                {
                  id: "42",
                  name: "元帅",
                  level: "2",
                  pid: "1",
                  status: "1",
                  sub: [],
                },
              ],
            },
            {
              id: "8",
              name: "香蕉",
              level: "2",
              pid: "1",
              status: "1",
              sub: [],
            },
          ],
        },
        {
          id: "2",
          name: "食品",
          level: "1",
          pid: "0",
          status: "1",
          sub: [
            {
              id: "5",
              name: "馒头",
              level: "2",
              pid: "2",
              status: "1",
              sub: [],
            },
            {
              id: "6",
              name: "大米",
              level: "2",
              pid: "2",
              status: "1",
              sub: [],
            },
          ],
        },
      ],

我这里的sub相当于children,可以看到我最小的子集,仍有sub:[ ] ,导致渲染空

解决:处理源数据(这里源数据☞  options),我看其他解决方式是将为空的children赋值为undefine,也有直接处理源数据,取出要用的数据,这里我把两种方式都写下来,可以择一使用,

第一种:

// 递归判断列表,把最后的sub设为undefined sub也就是源数据里的children
    getTreeData(data) {
      for (var i = 0; i < data.length; i++) {
        if (data[i].sub.length < 1) {
          // sub若为空数组,则将sub设为undefined
          data[i].sub = undefined;
        } else {
          // sub若不为空数组,则继续 递归调用 本方法
          this.getTreeData(data[i].sub);
        }
      }
      return data;
    },

第二种是将源数据过滤掉children,把主要数据取出来,放在一个新数组,这样就得到一个新的没有children的数组了,在使用时调用该方法就可以啦

 

 getTreeData(datas) {
      let data = [];
      datas.map((item) => {
        if (item.sub.length > 0) {
          let dadax = {
            label: item.name,  //这是需要展示的数据 我的数据是name,所以label对应的是name
            value: item.id,
            sub: this.getTreeData(item.sub),
          };
          data.push(dadax);
        } else {
          let dadax = {
            label: item.name,
            value: item.id,
          };
          data.push(dadax);
        }
        return data;
      });
      return data;
    },

Bug2    在做数据回显时,总是回显不出数据,找遍了各种方式还是没解决,到后来才发现在props里多加了个属性,导致不回显数据

下面,先说数据是怎么回显的,其实很简单,只需要后端把对应的层级关系的节点id就可以啦

例如我的   尤其要特别注意 给后端大佬说清 需要的数据格式 是 一个大的数组 里面是一个一个的小数组,一个数组代表了一个回显的数据,我这里做的是多选的,所以回显的数据比较多,这里以两个为例,多个回显数据就很多几条数组就可以啦   

 tips:在找其他答案的时候偶然发现也可以通过官方文档的getCheckedNodes方法来拿到选择过的数据然后再用v-model来绑定,也可以回显数据,这个方法我没试,应该也是可以的

 接下来,就要说说我踩得冤坑了,主要还是不熟悉el-casasder组件,乱加属性emitPath:false,这里是解决项目字段和组件字段不对应的方式,el-cascader默认显示的字段是label

 如果想具体了解下emitPath的用法可以参考element-ui的官网  

 到此,算是对el-cascader的使用告一段落了,有缺失的地方,也希望多多补充,觉得可以的话,就给俺点个赞吧

 

### 解决 `el-cascader` 多选数据不回显的问题 对于 `el-cascader` 组件在多选模式下遇到的数据不回显问题,可以通过调整组件配置来实现正常显示。具体来说: 当设置 `multiple=true` 后,如果切换单双选状态可能导致原有绑定值无法正确映射至视图层,进而造成数据显示异常[^1]。 为了确保多选情况下能够顺利回显已选项,需注意以下几点: #### 1. 正确传递路径数组作为初始值 由于 `el-cascader` 的工作原理依赖于完整的层级关系链路表示法——即每一项的选择都应由其所属的所有上级节点ID构成的一个列表形式给出;因此,在初始化时所提供的默认选定值也应当遵循这一规则,而不是仅仅提供最底层节点的信息[^3]。 例如: ```javascript // 错误做法:仅传入叶子结点 ID 列表 selectedValues = ['leafNodeId']; // 正确做法:完整路径组成的二维数组 selectedValues = [ ['parentId', 'childId'], ... ]; ``` #### 2. 使用特定 props 属性优化行为 通过向 `props` 对象内增加额外字段可简化某些场景下的操作复杂度。特别是针对不需要展示全部祖先节点的情况,可以利用 `emitPath=false` 参数让最终提交的结果只包含末端子项的标识符,这有助于减少不必要的冗余信息传输并提高用户体验[^2]。 示例代码如下所示: ```html <template> <div> <!-- ... --> <el-cascader ref="cascaderRef" v-model="form.modelList" :options="options" clearable filterable placeholder="请选择" :props="{ label: 'objectName', value: 'objectId', multiple: true, emitPath: false // 关键配置 }" @change="handleChangeModelId"> </el-cascader> <!-- ... --> </div> </template> <script setup lang="ts"> import { reactive } from "vue"; const form = reactive({ modelList: [], // 初始化为空数组或其他预设值 }); function handleChangeModelId(value) { console.log('Selected:', value); } </script> ``` 上述方法可以帮助解决 `el-cascader` 在启用多选功能后的数据同步难题,使得前端页面能准确反映出后台下发的有效选择记录。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值