Vue3 插槽使用详解

---

前言-认识slot

我们经常会有封装组件的需求, 组件需要的往往不只有数据, 有时候我们要给一个模块做内容方面的可自定义, 比如我封装了一个黑板, 但是我有时希望上面是字, 又有时希望上面是图画, 这就要用到插槽了.

感谢你浪费一分钟生命读完了这段废话.

---

一、简单插槽

就是普通插槽, 也叫默认插槽.
只要你在子组件里写一个< slot>就可以从父组件向内部填充了.
虽然简单但是不写slot也是不能直接从父组件插内容的.
子组件:

<template>
  <div class="sy-page">
    <slot>slot>
  div>
template>

父组件:

<template>
  <sy-turning>BaiXsy-turning>
template>

缺点就是不能规定父组件填充内容所指向的插槽, 父组件内填充的所有内容, 会填充到每个子组件内的插槽中:
子组件:

<template>
  <div class="sy-page">
    <slot>slot>
    <a href=""><slot>slot>a>
  div>
template>

父组件:

<template>
  <sy-turning>BaiXsy-turning>
template>

要解决这个问题 就需要具名插槽了.

---

二、具名插槽

特点是带有name属性:

<slot name="xxx">slot>

有时我们会需要在子组件某处写一堆的插槽,又需要在父组件各处分别使用这些插槽.
某些方面计算机是很笨的,它不会看得出哪个插槽该填什么东西,也不知道你在这里填的东西是要给哪个插槽, 你得告诉她该怎么做.

只要有使用多个插槽的需求, 那就用具名插槽吧.
先来看看子组件:

  <div class="tab-bar-item">
    <slot name="item-icon">slot>
    <slot name="item-text">slot>
  

父组件
< template>来包裹要向插槽里填充的东西, 在template标签的v-slot属性后面写上对应插槽的name值.

v-slot:可以简写为"#"

  <tab-bar-item>
  
    <template v-slot:item-icon>
      <div>插槽item-icon内容<img src="#" />div>
    template>
  
    <template #item-text>
      <div>插槽item-text内容div>
    template>
    
  tab-bar-item>

这样所有在template包裹下的填充内容都会被填入对应的插槽,但如果没有被template包裹呢?
那样就相当于写了个这:

  <template>
  
    <p>我会被填入子组件的每个插槽p>
  template>

Vue官方文档: 没有被包裹在带有 v-slot: 的 < template> 中的内容都会被视为默认插槽内容.

---

具名插槽扩展-动态插槽名

从 2.6.0 开始，可以用方括号括起来的JS表达式作为一个指令(v-bind啥的)的参数,比如在此例中

//随便定义一个方法randomName, 使用这个方法的返回值;
<a v-bind:[randomName]="user"> ... </a>

其实这个东西最常见的是在封装组件时, 我们用computed里的方法返回值来控制:class和:style:

<button
  :class="[theme, isBorder]"
>button>

computed: {
  theme() {
    return this.type ? `sy-button-${this.type}` : "";
  },
  isBorder() {
    return this.border ? "is-border" : "";
  },
}

在2.6版本新增的内容中, 这种用法(动态指令参数)也可以用在具名插槽上定义动态的插槽名, 这其实是具名插槽的扩展用法, 你可以先看看具名插槽.

<base-layout>
  <template v-slot:[动态指令参数]>
    动态决定插入哪个插槽
  template>
base-layout>

---

三、作用域插槽

父组件内需要访问子组件中的数据以正常工作, 可以作用域插槽.
作用域插槽的渲染是在子组件完成, 所以我们也需要子组件的数据.

在子组件的slot上利用v-bind / v-for之类绑定上父组件需要的各种数据, 渲染时就可以从子组件拿数据来渲染.

绑定在 < slot> 上的属性被Vue官方称为"slotProps"(这并不重要);
子组件:

<span class="current-user">
  <slot :user="data.user">slot>
span>


<span v-for="item in data.someThing" :key="item">
  <slot :num="item.num" :awsl="item.id">slot>
span>

在父组件内使用v-slot属性接收子组件数据;
父组件

<current-user>
  <template v-slot="{ user, name }">
  
  template>
current-user>

<current-user>
  <template v-slot="num"> 
  template>
current-user>

作用域插槽会被解析为一个传入了slotProps作参的函数:

function (slotProps) {
  // 插槽内容
}

所以, 父组件中v-slot: 的值实际上可以是任何 [能作为函数的参数来传入] 的东西;

---

作用域插槽实例

我现在二次封装一个el-tabs, 实现传入数据数组自动生成:
子组件:

<div class="sy_tabs">
  <el-tabs>
    <el-tab-pane
      v-for="item in sy_tab_data"
      :key="item"
      :label="item.label"
      :name="item.name"
    >
      <slot :item="item">slot>  
    <ul>
      <li
        v-for="i in data.article_content[slotProps.item.id]"
        :key="i"
       >
       
      li>
    ul>
  template>
sy-tabs>

let data = reactive({
  article_content: [
    [xxx, xxx], //详细数据略
    [xxx, xxx],
    [xxx, xxx],
  ]
})

就可以正常呈现了:

---

总结

注意 v-slot 只能添加在 < template> 上, 不然会标红;

我为什么要把这些玩意儿写在插槽里, 这么麻烦为什么不直接写那些标签?
是,我一开始也在问我自己, 为什么不直接写标签而要写插槽.

（现在是22年4月22, 我刚做完我的个人网站, 回来说一句, 不封装实在是——太乱了代码很多，就算复制粘贴下来到别处还要改属性改参数改样式，主要是还要改样式，老天！做了三个页面我就开始封装了。）

以上是我据本阶段的学习得出的一些经验与心得，如果帮到了您，在下十分荣幸；若是您发现了不足，您可以在评论区指出, 我会感谢您的指点的!