记一次解决element-plus警告的经历

背景

最近在做 Vue3 + Element-plus 的项目,启动项目之后发现控制台报了一堆警告,如下图:

虽然有警告,但是页面是正常运行的,但是身为一名有代码洁癖的程序员,控制台一堆警告怎么能忍。正好今天有空,仔细研究下这个问题。

分析问题

首先看下提示信息 no vaild child node found,翻译过来就是:没有找到有效的子节点。

根据这个提示信息我们只能知道有一个组件需要子节点,但是我们没有提供,但是具体是哪个组件呢?根本不知道。

没办法,接着往下看发出警告的 error.ts 文件吧。文件内容如下:

可以看出来是element-plus发出的警告,不过这文件只是一个ts类型定义文件,看不出来具体是什么报错。

那再看下一个文件only-child.tsx文件,文件内容如下:

可以看到该文件中定义了一个OnlyChild的Vue组件,具体分析下该组件:

  • 组件在setup阶段获取到当前默认插槽内容
  • 如果默认插槽内容长度大于1,则提示只能有一个子元素,并返回null
  • 之后获取插槽内容的的子元素,如果没有子元素,就会发出前面碰到的警告,并返回null
  • 如果默认插槽内容没问题,则使用自定义指定包装下firstLegitNode元素(因为这块与本次探讨的报错无关,故不展开说明)

再看下下面的findFirstLegitChild方法,该方法会遍历传入的VNode节点的子元素,直到Text或svg节点,之后将节点内容以span标签包裹,span标签的内容为Text或svg的内容。并且该方法可以一直查找子元素,直到找到可供显示的文字信息。

分析到这里,基本可以确定是OnlyChild这个组件默认插槽内没有任何子元素导致的,但是在element-plus的组件中并没有OnlyChild这个组件,那看来这个组件是element-plus内部的一个组件,不对外暴露。

问题解决

至此,分析的线索貌似是断了,不过可以使用二分法定位出错的组件

首先找到出错的页面,注释页面中的部分组件,再返回浏览器查看控制台是否还存在报错

如此这样,逐步缩小组件范围,最终定位在el-tooltip组件,这里贴下具体出错的代码:

js 复制代码
<el-tooltip :content="case_title" placement="top-start" effect="light" :show-after="TOOLTIP_SHOW_AFTER">
   <div v-if="case_title" class="one-line-ellipsis">{{ case_title }}</div>
</el-tooltip>

这样一看问题就比较明显了,el-tooltip的默认插槽使用了v-if做判断,当case_title为空时,该默认插槽的内容就是空,命中了子元素为空的情况,因而触发了警告。

为了解决该问题,我们只需要将v-if挪到el-tooltip上或是为子元素在最外层再套一层div,保证el-tooltip的子元素肯定存在即可。

相关推荐
念何架构之路1 分钟前
zap扩展生态与总结
java·前端·数据库
独孤九剑打醒他16 分钟前
【原创开源】【概念设计】源 - 栅 - 漏 - 栅 - 源 横向双栅 MOS,低压交流多值逻辑芯片探索
前端·其他·架构·开源·硬件工程
mantou1321 小时前
我给 AI Agent 做了个「油猴」:让 Claude Code / Codex 直接用你已登录的浏览器
前端·javascript·后端
默_笙1 小时前
🍕 一个主编、三个工种、两本手册:搭一支 AI 调研队
前端·javascript
纸片人1 小时前
Blender 建模 + Three.js 展示:和 AI 一起做一个光储充超充站数字孪生大屏
前端
智能直播1 小时前
网络RTMP拉流不卡顿、声音不同步?一文讲透缓冲区、时间戳与MEDAI V2实战调优
前端
第七页独白1 小时前
汽车零件厂如何通过 QMS 真正落地 IATF 16949——QMS软件系统:品质检验-内审稽核-8d客诉管理:全星质量管理软件系统
java·前端·数据库
纸片人1 小时前
只用 three.js + OpenStreetMap,手搓一个「成都城市 3D」数据大屏
前端
星若生辉1 小时前
Hugo 静态站点搭建|从本地调试到上线部署实操指南
前端
沐浴露z1 小时前
Agent 响应延迟过高?从工具治理角度提供两条思路
前端·网络