Vue多级菜单递归插槽需组件自调用+手动透传插槽,显式命名、逐层解构#default插槽并传递props,暴露item/depth/open等上下文,按type动态渲染,结合v-if控制展开深度、Teleport虚拟滚动及唯一key优化性能。

Vue 中处理多级菜单嵌套的递归插槽,核心在于「组件自调用 + 插槽透传」。不能只靠一层 <slot></slot> 就完事,必须在每次递归调用时,把当前层的插槽内容原样交到下一层去——否则子节点就收不到定制 UI 的能力。
递归组件必须显式命名并手动透传插槽
组件需设置 name(如 TreeMenuItem),模板中才能用自身名字递归引用。更重要的是:插槽不会自动继承,每层都得手动包裹并传入子组件:
- 父节点用
<template></template>接收并解构插槽上下文 - 内部递归调用
<treemenuitem></treemenuitem>时,同样用<template></template>包裹,并把插槽内容透传下去 - 禁止在
setup里用useSlots()手动执行插槽函数——会丢失响应性与作用域绑定
插槽上下文要暴露关键字段
每一层递归节点应向插槽提供足够信息,让外部能做条件渲染和交互控制:
-
item:当前节点完整数据,至少含name、children、id、isFolder、type -
depth:当前层级(从 0 或 1 开始),用于缩进、禁用深层操作、限制默认展开深度 -
open:是否已展开(响应式状态,支持 v-model 绑定) -
selected、loading等按需补充,便于渲染复选框、加载图标等
按节点类型动态渲染不同内容
利用 item.type 或 item.isFolder 在插槽内分支处理:
立即学习“前端免费学习笔记(深入)”;
- 文件夹节点:显示折叠按钮(+ / −)、半选 checkbox、右键菜单入口
- 接口节点:根据
item.method(GET/POST)切换图标,加“调试”“复制路径”按钮 - 测试节点:插入运行状态徽标、耗时 badge、最近执行时间
- 禁用节点:文字置灰 + 移除所有可点击元素,但保留
title提示
性能优化不能只靠插槽机制
大数据量或深层嵌套下,需叠加策略防止卡顿和状态错乱:
- 用
v-if="item.open || depth 控制初始渲染深度,首屏只展开前两层 - 对子节点区域使用
<teleport to="#virtual-tree-portal"></teleport>配合虚拟滚动容器 - 为每个节点设唯一
:key="item.id",避免多选状态因 key 复用而漂移 - 高频更新区域(如计数 badge)拆成具名插槽,方便单独 memoize 或懒编译


















