vue3中slot（插槽）的使用

插槽的用途就和它的名字一样：有一个缺槽，可以插入一些东西。

插槽slot通常用于两个父子组件之间，最常见的应用就是我们使用一些UI组件库中的弹窗组件时，弹窗组件的内容是可以自定义的，这就是使用了插槽的原理。

1，slot的基本使用

我们在项目中新建一个 child.vue 文件，用来当作子组件，它的代码也非常的简单。

child.vue 代码如下：

<template>
  <div class="child-box">
    <p>我是子组件</p>
    <!-- 插槽 -->
    <slot></slot>
  </div>
</template>
<style>
.child-box {
  display: flex;
  flex-direction: column;
  align-items: center;
}
</style>

然后我们直接在 App.vue 引用该子组件，代码如下：

<template>
  <img alt="Vue logo" src="./assets/logo.png" />
  <child></child>
</template>
​
​
<script setup lang="ts">
import Child from "./child.vue";
</script>

child 子组件代码非常的简单，唯一不同的里面我们添加了一对标签，这就是插槽标签。这对标签就好比我们在 child 组件内部挖了一个槽出来，我们接下来就可以往这个槽里面放置一些内容。

那么我们如何往这个槽里面放置内容呢？

我们在 App.vue 里面通过一对闭合标签调用了子组件，我们都知道 HTML 标签之间是可以插入内容的，虽然 child 不是 HTML 自带的标签，但是它却有着类似的特征，比如我们往之间插入一点内容，代码如下：

<template>
  <img alt="Vue logo" src="./assets/logo.png" />
  <child>
    <div>vue3插槽测试</div>
  </child>
</template>

我们发现在标签之间插入的内容被渲染出来了，那么这是为何呢？

前面我们说 slot 就是挖了一个槽出来，可以放置东西，这里我们在父组件中添加的 div 便就是我们要添加的东西，子组件中 slot 标签被替换为了我们插入的 div 元素。这就是插槽的最基本使用。

结论：

为了更好理解插槽，简单总结为以下几点：

• slot 是 Vue3 中的内置标签。
• slot 相当于给子组件挖出了一个槽，可以用来填充内容。
• 父组件中调用子组件时，子组件标签之间的内容元素就是要放置的内容，它会把 slot 标签替换掉。

最简单的理解： 我们的使用 U 盘需要将 U 盘插入 USB 口中，此时 USB 口就是插槽，U 盘就是插口。在 Vue 中，就是电脑插槽，父组件的内容就可以理解为 U 盘插口。

2.插槽默认内容

我们通常将插槽比作一个占位符，有内容进来时，自动把 slot 给替换掉。但是，如果没有内容进来时，那么应该渲染什么呢？

在很多场景下都会有这种需求，比如 UI 组件库中的弹窗，如果我们没有传入弹窗的头部或者底部，那么弹窗便会有默认的样式效果，这里就用到了 slot 的默认内容功能。

修改一下 child.vue 代码：

<template>
  <div class="child-box">
    <p>我是子组件</p>
    <!-- 插槽 -->
    <slot>
      <p>我是默认内容</p>
    </slot>
  </div>
</template>

当我们的 App.vue 没有向 child 组件传入内容时，会是什么效果呢？

App.vue 代码如下：

<template>
  <img alt="Vue logo" src="./assets/logo.png" />
  <child></child>
</template>

可以看到子组件同样渲染了内容，而且就是 slot 标签内的内容。那么我们我们往 child 组件传入一点内容会是什么效果呢？

<template>
  <img alt="Vue logo" src="./assets/logo.png" />
  <child>
    <div>{{ message }}</div>
  </child>
</template>
​
​
<script setup lang="ts">
import { ref } from "vue";
import Child from "./child.vue";
const message = ref("vue3插槽测试");
</script>

可以看到此时页面上渲染的 App.vue 父组件传入的内容了。

总结：

从上面例子不难看出，slot 标签内的内容就是默认内容，也就是当父组件没有传递给子组件内容时，子组件就会默认渲染 slot 内部的内容，但是 slot 标签是不会渲染出来的。

3，具名插槽

很多时候我们子组件中都不止只有一个 slot，比如弹窗组件，我们可能允许调用者同时传入 header、content、footer 等等，这个时候如果子组件中只有一个 slot，那么这么多内容该如何区分，或者说该如何渲染呢？

3.1 基本使用

这时候为了区分插槽与内容的对应关系，可以分别给slot和内容都加上一个名字，插入插槽的时候按照名字区分好就可以了

我们给child组件添加上多个slot，并且给每个slot取上一个名字。

代码如下：

<template>
  <div class="child-box">
    <p>我是子组件</p>
    <header>
      <slot name="header"></slot>
    </header>
    <main>
      <slot></slot>
    </main>
    <footer>
      <slot name="footer"></slot>
    </footer>
  </div>
</template>

上段代码中我们添加了 3 个 slot 插槽，并且给其中两个 slot 标签添加了一个 name 属性，也就是每个插槽的名字。需要注意的是，上段代码中有一个插槽我们没有添加 name 属性，这个时候 Vue 会隐式的将这个插槽命名为“default”，接下来就是我们父组件 App.vue 添加内容了。

代码如下：

<template>
  <img alt="Vue logo" src="./assets/logo.png" />
  <child>
    <template v-slot:header>
      <div>我是 header：{{ message }}</div>
    </template>
    <div>我没有名字：{{ message }}</div>
    <template v-slot:footer>
      <div>我是 footer：{{ message }}</div>
    </template>
  </child>
</template>

既然 slot 有了名字，那么我们在父组件中传入内容时就要和名字关系对应起来，我们采用 v-slot:header 指令的形式找到对应的插槽，需要注意的是该指令需要作用在 template 元素上。从上图可以看出，我们传入的内容都渲染到了对应的插槽内，没有命名的插槽渲染了我们传入的未添加指令的内容。

3.2 简写

在 Vue 中，很多指令都有简写形式，v-slot:name 指令也有简写形式，比如看我们下面的示例

原写法：

<template v-slot:footer>
</template>

简写法：

<template #footer>
</template>

4 默认插槽与具名插槽混用

当一个子组件中既有具名插槽，又有默认插槽时，该如何渲染呢？

前面我们说默认插槽会被隐式的命名为default，所以我们传入内容时可以将插槽名字改为default即可。

修改child组件：

<template>
  <img alt="Vue logo" src="./assets/logo.png" />
  <child>
    <template v-slot:header>
      <div>我是 header：{{ message }}</div>
    </template>
    <template v-slot:default>
      <div>我没有名字：{{ message }}</div>
      <div>我没有名字：{{ message }}</div>
      <div>我没有名字：{{ message }}</div>
    </template>
    <template v-slot:footer>
      <div>我是 footer：{{ message }}</div>
    </template>
  </child>
</template>

虽然说子组件中有一个slot没有取名字，但是默认可以用default来代表它，就好比人刚出人的时候没有名字，但是他又是一个默认属性：’人‘，。

当然，既然大家都是默认的，在父组件中你也可以不用名字，这个时候内容会默认传入到未命名插槽中去。

代码如下：

<template>
  <img alt="Vue logo" src="./assets/logo.png" />
  <child>
    <template v-slot:header>
      <div>我是 header：{{ message }}</div>
    </template>
    <div>我没有名字：{{ message }}</div>
    <div>我没有名字：{{ message }}</div>
    <div>我没有名字：{{ message }}</div>
    <template v-slot:footer>
      <div>我是 footer：{{ message }}</div>
    </template>
  </child>
</template>

5.动态插槽名

前面我们给插槽名的时候都是直接写死的，其实我们有时候可以动态给插槽命名的，以满足更多的业务场景。

代码如下：

<base-layout>
  <template v-slot:[dynamicSlotName]>
    ...
  </template>
  <!-- 缩写为 -->
  <template #[dynamicSlotName]>
    ...
  </template>
</base-layout>

上端代码就是在父组件中采用动态插槽名传入内容的示例。

6.插槽作用域问题

我们仔细思考插槽的使用，会发现这有一点儿类似父子组件传递，只不过插槽传递的是模板内容罢了，那么涉及到传值，就会有一个作用域的问题，回顾一下APP.vue中的代码 。

代码如下：

<template>
  <img alt="Vue logo" src="./assets/logo.png" />
  <child>
    <div>{{ message }}</div>
  </child>
</template>
​
​
<script setup lang="ts">
import { ref } from "vue";
import Child from "./child.vue";
const message = ref("vue3插槽测试");
</script>

上段代码中message是父组件中定义的数据，但是在子组件child中渲染了出来，说明子组件中的插槽是可以访问到父组件中的数据作用域的，但是反过来是不行的，因为我们无法通过插槽拿到子组件的数据。

总结

所以这里我，我们总结为两点

• 插槽内容可以访问到父组件的数据作用域，就好比上述中的message是父组件的。
• 插槽内容无法访问到子组件的数据，就好比上述APP.vue中的插槽内容拿不到子组件child的数据。

7.作用域插槽

前一段我们说父组件中的插槽内容是无法访问到子组件中的数据的，但是，万一我们有需求就是需要在插槽内容中获取子组件数据怎么办呢？

vue3给提供了方法，使用起来比较简单。

7.1 默认插槽作用域传值

我们先来演示默认插槽如何获取子组件数据。

child.vue代码如下：

<template>
  <div class="child-box">
    <p>我是子组件</p>
    <slot text="我是子组件vue3插槽测试" :count="1"></slot>
  </div>
</template>

App.vue代码：

<template>
  <img alt="Vue logo" src="./assets/logo.png" />
  <child v-slot="slotProps">
    <div>{{ slotProps.text }}---{{ slotProps.count }}</div>
  </child>
</template>

上段代码中我们在子组件中slot标签上添加了一些自定义属性，属性值就是我们想要传传递给父组件的一些内容，在父组件App.vue中通过v-slot=“slotprops”等形式接收子组件传递过来的数据，slotProps的名字是可以任意取得，他是一个对象，包含了所有传递过来的数据。

需要注意得是，子组件传递过来的数据只能在子组件这个标签内使用。

解构写法：

我们都知道对象是可以结构的，所以我们在父组件中还可以直接使用解构的写法来获取数据。

代码如下：

<template>
  <img alt="Vue logo" src="./assets/logo.png" />
  <child v-slot="{ text, count }">
    <div>{{ text }}---{{ count }}</div>
  </child>
</template>

7.2具名插槽作用域传值

具名插槽作用域之间的传递其实默认插槽作用域传值原理是一样的，只不过写法不一样罢了。

child.vue代码如下：

<template>
  <div class="child-box">
    <p>我是子组件</p>
    <slot name="header" text="我是子组件vue3插槽测试" :count="1"></slot>
  </div>
</template>

App.vue代码如下：

<template>
  <img alt="Vue logo" src="./assets/logo.png" />
  <child>
    <template #header="{ text, count }">
      <div>{{ text }}---{{ count }}</div>
    </template>
  </child>
</template>

上段代码中我们给 slot 添加了一个 name，在父组件中接收数据的时候不在采用 v-slot=""形式了，而是直接再插槽内容上采用#header=""形式，当时这是简写形式，你也可以写为：v-slot:header=""

总结

插槽的作用非常广泛，学好插槽对我们的项目开发有着非常大的帮助，当然，想要非常优雅的使用插槽，还需要费一下功夫的。这里推荐大家看一下element组件库中的table的使用，看他是如何使用插槽的，如何优雅的将表格组件中的数据共享给父组件的。