【vue3】defineSlots, useSlots, $slots 记录/讲解

前情提要:深入vue2/3: 插槽 <slot> / v-slot 的使用与讲解_oumae-kumiko的博客-CSDN博客

若不会插槽的使用请先看该文章,下面的API内容全部基于上述内容!


$slots (声明了slot的子组件才使用该api)

  • 使用条件:

    1. 该API是在选项式API里使用的。也可在template里{{$slots}}进行访问。
    2. 功能:一个表示父组件所传入插槽的对象。
    3. 用于手写渲染函数,也可用于检测是否存在插槽。
    4. 每一个插槽都在 this.slots 上暴露为一个函数,返回一个 vnode 数组,同时 key 名对应着插槽名。如:默认插槽则暴露为 this.slots.default。具名插槽则是this.$slots.slotName ;"slotName"就是具名插槽的name。
    5. 需要使用渲染函数搭配渲染插槽的场景很少,当你需要的时候,说明功力不俗了,涉及内容较多本文章不进行讲述。
javascript 复制代码
<script lang='ts'>
import { defineComponent } from 'vue'
export default defineComponent({
    created(){
        console.log('$slots----',this.$slots);
        // console.log('$slots----',this.$slots.default()); // 调用对应实例插槽的api拿到插槽的内容。
        // console.log('$slots----',this.$slots.JuMingSlot());
    }
})
</script>

useSlots (声明了slot的子组件才使用该api)

  • 使用条件:

    1. 该API是在 setup 组合式API里使用的。
    2. 其他功能描述同 $slots 一致。
    3. useSlots()的返回值与 $slots 和 setupContext.slots 等价。
javascript 复制代码
<script lang='ts'>
import { defineComponent, useSlots } from 'vue'
export default defineComponent({
    setup(props, content){
        console.log(content.slots);
    }
})
</script>
<script setup lang='ts'>
import { useSlots } from 'vue'
cosnt slots = useSlots()
</script>

defineSlots() (声明了slot的子组件才使用该api)

  • 使用条件:

    1. 该API是在 <script setup> 里使用的。
    2. 仅支持 Vue 3.3+ 的版本。就因为新增了这API,让我写了这文章。
    3. 其他功能描述同 $slots 一致。
    4. 这个宏可以用于为 IDE 提供插槽名称和 props 类型检查的类型提示。
    5. defineSlots() 只接受TS类型参数,没有运行时参数。也就是说你项目不是TS的话,就不用看这个了。
    6. 它还返回 slots 对象,该对象等同于在 setup 上下文中暴露或由 useSlots() 返回的 slots 对象。
TypeScript 复制代码
<script setup lang="ts">
const slots = defineSlots<{
  // key > default 是插槽名称
  // 值类型是插槽函数
    // 函数的第一个TS对象类型参数是插槽期望接收的 props 的TS类型
    // 返回值类型目前被忽略,可以是 any,但官方说将来可能会利用它来检查插槽内容。
  default(props: { msg: string }): any
}>()
</script>

QQ交流群:522976012 ,欢迎来玩。

聚焦vue3,但不限于vue,任何前端问题,究其本质,值得讨论,研究与学习。

相关推荐
折果37 分钟前
如何在vue项目中封装自己的全局message组件?一步教会你!
前端·面试
不死鸟.亚历山大.狼崽子40 分钟前
Syntax Error: Error: PostCSS received undefined instead of CSS string
前端·css·postcss
汪子熙40 分钟前
Vite 极速时代的构建范式
前端·javascript
叶常落41 分钟前
[react] js容易混淆的两种导出方式2025-08-22
javascript
跟橙姐学代码41 分钟前
一文读懂 Python 的 JSON 模块:从零到高手的进阶之路
前端·python
前端小巷子1 小时前
Vue3的渲染秘密:从同步批处理到异步微任务
前端·vue.js·面试
nightunderblackcat2 小时前
新手向:用FastAPI快速构建高性能Web服务
前端·fastapi
每天学习一丢丢2 小时前
SpringBoot + Vue实现批量导入导出功能的标准方案
vue.js·spring boot·后端
小码编匠2 小时前
物联网数据大屏开发效率翻倍:Vue + DataV + ECharts 的标准化模板库
前端·vue.js·echarts
欧阳天风3 小时前
分段渲染加载页面
前端·fcp