什么是渲染函数中的插槽写法?Vue3 下使用 h 函数处理 Slot 全攻略

落宇酱_7189

落宇酱_7189

2026-05-29

719人浏览

原创

插槽在vue 3渲染函数中是函数而非内容,必须调用slots.default()等才能获取vnode数组;h函数接收vnode描述对象,不可直接传入未调用的插槽函数。

什么是渲染函数中的插槽写法?vue3 下使用 h 函数处理 slot 全攻略

渲染函数中插槽不是“写进去”的内容,而是“调用出来”的函数。Vue 3 的 h 函数本身不直接接收 HTML 字符串或模板字符串,它接收的是 VNode 描述对象;而插槽(slots)在 setup 或 render 函数中,本质是一组函数——slots.default()、slots.header()、slots.item({ item }) 等,只有执行它们,才返回真正的 VNode 数组。

插槽在 render 函数里是函数,不是内容

在使用 render() { return h(...) } 编写自定义渲染逻辑时,slots 是通过第二个参数(即 ctx 或解构出的 { slots })传入的。它不是现成的 DOM 片段,也不是字符串,而是一个对象,每个 key 对应一个插槽函数:

  • slots.default 可能为 undefined,需判断存在性再调用
  • slots.footer 是函数,调用后返回 VNode 数组(可能为空)
  • slots.item 是作用域插槽,调用时需传入响应式数据对象,如 slots.item({ item: currentData, index: i })

用 h 包裹插槽调用结果的正确姿势

不能把 slots.default 直接当子节点传给 h,必须调用它:

Auth0 Vue
Auth0 Vue

在 Vue.js 3 中添加身份验证(登录、注销、用户会话、受保护路由),集成 @auth0/auth0-vue SDK,配合 Vite 使用。

下载
  • ✅ 正确:h('div', [slots.default && slots.default()])
  • ✅ 带条件:h('section', slots.showHeader ? [slots.header()] : [])
  • ✅ 作用域插槽:h('ul', list.map((item, i) => h('li', slots.item?.({ item, index: i }) || []))
  • ❌ 错误:h('div', slots.default)(未调用,传入函数而非 VNode)
  • ❌ 错误:h('div', slots.default?.())(若 default 为 undefined,?.() 会返回 undefined,但 h 子节点数组中不能含 undefined)

安全调用插槽的实用模式

为避免运行时报错或空数组异常,建议封装可复用的调用逻辑:

  • 空值保护:用 slots.xxx?.() ?? [] 替代裸调用
  • 统一 fallback:对缺失插槽提供默认结构,例如 slots.footer?.() || h('p', '暂无底部信息')
  • 具名插槽映射:用对象映射动态 slot 名,如 const slotMap = { top: 'header', mid: 'default', bottom: 'footer' },配合 v-slot:[name] 动态语法更易维护
  • 工厂函数封装:将常用插槽逻辑抽成函数,如 renderListSlot = (items) => items.map(i => h('div', slots.item?.({ item: i }) || []))

动态插槽名与 h 的协同写法

当插槽名由变量控制(如 const currentSlot = ref('sidebar')),不能直接写 slots[currentSlot.value]——因为响应式变量需在渲染函数内读取,且需确保其值合法:

  • 先读取变量:const name = currentSlot.value
  • 再安全访问:const slotFn = name && typeof slots[name] === 'function' ? slots[name] : null
  • 最后调用:slotFn?.() ?? []
  • 完整示例:h('aside', slotFn?.({ side: name }) ?? [h('p', '未配置该插槽')])

前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2303

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

4943

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

6030

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

5538

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

783

5

vue2.0和3.0区别
vue2.0和3.0区别

vue2.0和3.0区别:vue2的响应式原理是利⽤“Object.defineProperty()”对数据进⾏劫持结合发布订阅模式的⽅式来实现,vue3中使⽤了es6的proxy API对数据代理,实现对数据的监控。本专题为大家提供vue2.0和3.0区别的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.17

1634

5

vue3的生命周期有哪些
vue3的生命周期有哪些

vue3的生命周期:1、beforecreate;2、created;3、beforemount;4、mounted;5、beforeupdate;6、updated;7、beforedestroy;8、destroyed;9、activated;10、deactivated等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

11882

5

Vue3组合式API与组件开发实战
Vue3组合式API与组件开发实战

本专题讲解 Vue 3 组合式 API 的核心概念与应用技巧,深入分析响应式系统、生命周期管理、组件设计与复用策略。通过完整项目案例,指导前端开发者实现高性能、结构清晰的 Vue 应用,提升开发效率与代码可维护性。

2026.02.10

296

23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app快速上手
uni-app快速上手

共0课时 | 0人学习

Vue 教程
Vue 教程

共42课时 | 16.9万人学习

Vue3.x 工具篇--十天技能课堂
Vue3.x 工具篇--十天技能课堂

共26课时 | 2.5万人学习