Vue组件化-3-slot 插槽 | 青训营笔记

114 阅读7分钟

这是我参与「第四届青训营 」笔记创作活动的的第6天

slot-插槽

为什么使用插槽

slot翻译为插槽: 在生活中很多地方都有插槽,电脑的USB插槽,插板当中的电源插槽。 插槽的目的是让我们原来的设备具备更多的扩展性。 比如电脑的USB我们可以插入U盘、硬盘、手机、音响、键盘、鼠标等等。

组件的插槽: 组件的插槽也是为了让我们 封装的组件 更加具有 扩展性。 让使用者可以 决定 组件内部的一些内容到底展示什么。

栗子:移动网站中的导航栏。 移动开发中,几乎每个页面都有导航栏。 导航栏我们必然会封装成一个插件,比如nav-bar组件。 一旦有了这个组件,我们就可以在多个页面中复用了。 但是,每个页面的导航是一样的吗?No

如何去封装插槽

如何去封装这类的组件呢? 它们也很多区别,但是也有很多共性。 如果,我们每一个单独去封装一个组件,显然不合适: 比如每个页面都返回,这部分内容我们就要重复去封装。 但是,如果我们封装成一个,好像也不合理: 有些左侧是菜单,有些是返回,有些中间是搜索,有些是文字,等等。

如何封装合适呢?抽取共性,保留不同

最好的封装方式就是 将共性抽取到组件中,将不同暴露为插槽。

一旦我们预留了插槽,就可以让使用者根据自己的需求,决定插槽中插入什么内容。 是搜索框,还是文字,还是菜单。由调用者自己来决定。 这就是为什么我们要学习组件中的插槽slot的原因。

slot插槽的基本使用

在子组件中,使用特殊的元素<slot></slot>就可以为子组件开启一个插槽。

该插槽插入什么内容取决于父组件如何使用。

<slot>中的内容表示,如果没有在该组件中插入任何其他内容,就默认 显示该内容

  1. 插槽的基本使用:
  2. 插槽的默认值:按钮
  3. 如果有多个值,同时放到组件进行替换,一起作为替换元素

插槽可以插入组件

<div id='a'>
  <cpn1></cpn1>
  <cpn1>
    <i>这是i标签</i>
    <span>这是span标签</span>
  </cpn1>
  <cpn1><input type="text"></cpn1>
  <cpn1><ccpn1></ccpn1></cpn1>
  <!-- 可以插入组件 -->
</div>
<template id="cpn1">
  <div>
    <h2>这是标题</h2>
    <p>这是p元素</p>
    <slot><button>按钮</button></slot> 
    <!--  如果父组件使用子组件时没有添加内容,默认显示该内容,
          如果父组件使用子组件时添加了内容,将添加的内容整体替换slot标签
    -->
  </div>
</template>
<template id="ccpn1">
  <div>
    这是ccpn1组件
  </div>
</template>
<script src='./vue.js'></script>
<script>
  Vue.component('ccpn1',{
    template : '#ccpn1'
  })
    const a = new Vue({
        el : '#a',
        data : {
        },
        methods : {},
        computed : {},
        components : {
          cpn1 : {
            template : '#cpn1'
          }
        }
    })
</script>

具名插槽

当子组件的功能复杂时,子组件的插槽可能并非是一个。

比如我们封装一个导航栏的子组件,可能就需要三个插槽,分别代表左边、中间、右边。 那么,外面在给插槽插入内容时,如何区分插入的是哪一个呢? 这个时候,我们就需要给插槽起一个名字

如何使用具名插槽呢? 非常简单,只要给slot元素一个name属性即可

在子组件模板中<slot name='myslot'></slot>

在父组件中使用:<cpn2> <h2 slot="myslot">标题</h2> </cpn2>

插槽和具名插槽和作用域插槽建议看官方, 版本升级改了 用v-slot 了 或者直接#center=""

官网: 在 2.6.0 中,我们为具名插槽和作用域插槽引入了一个新的统一的语法 (即 v-slot 指令)。 它取代了 slot 和 slot-scope 这两个目前已被废弃但未被移除. 新用法就是,大模板里面的东西不变,变的是定义在html元素中的slot变成模板加上v-slot就行

在vue3中,
    在子组件中 `<slot name="header"></slot>`
    一个不带 name 的 <slot> 出口会带有隐含的名字“default”。
    即:<template v-slot:default></template>

  在父组件中使用为:
  <template v-slot:header>
    <h1>Here might be a page title</h1>
  </template>

  <template v-slot:default>
    <p>A paragraph for the main content.</p>
    <p>And another one.</p>
  </template>

vue3中

注意,v-slot 只能添加在<template></template>上 (只有一种例外情况)

例外情况:

当被提供的内容只有默认插槽时,组件的标签 才可以被当作 插槽的模板 来使用。
这样我们就可以把 v-slot 直接用在组件上:
<todo-list v-slot:default="slotProps"></todo-list>

这种写法还可以更简单。
就像假定未指明的内容对应默认插槽一样,不带参数的 v-slot 被假定对应默认插槽:
<todo-list v-slot="slotProps">

注意默认插槽的缩写语法不能和具名插槽混用,因为它会导致作用域不明确:

<code>
  <!-- 无效,会导致警告 -->
  <todo-list v-slot="slotProps">
    <i class="fas fa-check"></i>
    <span class="green">{{ slotProps.item }}</span>
    
    <template v-slot:other="otherSlotProps">
      slotProps is NOT available here
    </template>
  </todo-list>
</code>

只要出现多个插槽,请始终为所有的插槽使用完整的基于 <template></template>的语法:
  即:每个插槽都要在 template 标签上写 v-slot


<div id='b'>
  <!-- <cpn2 slot="center"> <h2>标题</h2>  </cpn2>  -->
  <!-- 这样写可以替换没有name属性的slot -->

  <cpn2> <h2 slot="center">标题</h2> </cpn2>
  <!-- 正确写法 -->
  <cpn2> <button slot="left">按钮</button> </cpn2>
</div>
<template id="cpn2">
  <div>
    <slot name="left"><span>我是左边</span></slot> 
    <slot name="center"><span>我是中间</span></slot> 
    <slot name="right"><span>我是右边</span></slot> 
  </div>
</template>

<script src='./vue.js'></script>
<script>
    const b = new Vue({
        el : '#b',
        data : {
        },
        methods : {},
        computed : {},
        components : {
          cpn2 : {
            template : '#cpn2'
          }
        }
    })
</script>

编译作用域

在真正学习插槽之前,我们需要先理解一个概念:编译作用域

官方对于编译的作用域解析比较简单,我们自己来通过一个例子来理解这个概念:

<div id='c'>
  <cpn3 v-show="isShow"></cpn3>
</div>
<template id="cpn3">
  <div>
    <p >我是子组件的数据</p>
    <!-- <p v-show="isShow">我是子组件的数据</p> -->
  </div>
</template>

<script src='./vue.js'></script>
<script>
    const c = new Vue({
        el : '#c',
        data : {
          isShow : true
        },
        methods : {},
        computed : {},
        components : {
          cpn3 : {
            template : '#cpn3',
            data(){
              return {
                isShow : false
              }
            }
          }
        }
    })
</script>

我们来考虑上面的代码是否最终是可以渲染出来的:

<my-cpn v-show="isShow"></my-cpn>中,我们使用了isShow属性。 isShow属性包含在组件中,也包含在Vue实例中。

答案:最终可以渲染出来,也就是使用的是Vue实例的属性。

为什么呢?

官方给出了一条准则: 父组件模板的所有东西都会在父级作用域内编译;子组件模板的所有东西都会在子级作用域内编译。 而我们在使用的时候, 整个组件的使用过程是相当于在 父组件 中出现的。 那么他的 作用域 就是 父组件,使用的属性也是 属于父组件 的属性。 因此,isShow使用的是Vue实例中的属性,而不是子组件的属性。

在哪里使用,作用域在哪,在自己的作用域里查找


作用域插槽

作用域插槽是slot一个比较难理解的点,而且官方文档说的又有点不清晰。 这里,我们用一句话对其做一个总结,然后我们在后续的案例中来体会: 父组件替换插槽的标签,但是内容由子组件来提供。

我们先提一个 需求: 子组件中包括一组数据,比如:pLanguages: ['JavaScript', 'Python', 'Swift', 'Go', 'C++'] 需要在多个界面进行展示: 某些界面是以水平方向一一展示的, 某些界面是以列表形式展示的, 某些界面直接展示一个数组 内容在子组件,希望父组件告诉我们如何展示,

怎么办呢? --- 利用slot作用域插槽就可以了

在父组件使用我们的子组件时,从子组件中拿到数据: 我们通过 <template slot-scope="slotProps"></template>获取到 slotProps 属性 再通过 slotProps.data 就可以获取到刚才我们传入的 data了

子组件挖坑,父组件填坑,作用于插槽,子组件挖坑提供数据,父组件拿数据填坑.

slot–scoped="slot"的solt只是随便起的一个名字,是对象类型,用于接收子组件传过来的一个个键值对, :abc=planguage中的abc是键名随便起的plangguage是子组件数据

插槽和作用域插槽引入了一个新的统一的语法 (即 v-slot 指令)。 它取代了 slot 和 slot-scope 这两个目前已被废弃但未被移除且仍在文档中的 attribute--属性

注意::data属性名这里可以随便改自己喜欢的名字,但是必须要小写,v-slot的也是一样要注意小写

vue3 中 slot 和 data 都可以随便起名,但是要注意 小写

语法糖 v-slot:aaa="slot" 可以简写为#aaa="slot"

注意:#="slot" 是无效的, 必须始终以明确插槽名取而代之: #default="slot"

动态的插槽名:v-slot:[dynamicSlotName]

可以使用动态参数为一个动态的事件名绑定处理函数:
<a v-on:[eventName]="doSomething"> # </a>
在这个示例中,当 eventName 的值为 "focus" 时,
v-on:[eventName] 将等价于 v-on:focus

<a v-bind:[attributeName]="url"> ... </a>
这里的 attributeName 会被作为一个 JavaScript 表达式进行动态求值,求得的值将会作为最终的参数来使用。
例如,
  如果你的组件实例有一个 data property attributeName,其值为 "href",
  那么这个绑定将等价于 v-bind:href

  vue3
  <!-- <template v-slot:aaa="slot"> -->
  <template #aaa="slot">
    <span>{{slot.data}}</span>
  </template>

  <slot name="aaa" :data="pLanguages"> </slot> 

解构插槽 Prop ??没看懂 v3.cn.vuejs.org/guide/compo…


<div id='d'>
  <cpn4></cpn4>
  <cpn4>
    <template slot-scope="slotname">
      <!-- <span v-for="item in slotname">{{item.dataname}} - </span> -->
      <!-- 错误,只显示一个- -->

      <span v-for="item in slotname.dataname">{{item}} - </span>
      <!-- <span>{{slotname.dataname.join(' - ')}}</span> -->
    </template>
  </cpn4>

  <cpn4>
    <template slot-scope="slotname">  <!-- slotname 、dataname 可以随便起  但小写-->
      <!-- <span v-for="item in slotname.dataname">{{item}} * </span> -->
      <span>{{slotname.dataname.join(' * ')}}</span>
    </template>
  </cpn4> 
</div>

<template id="cpn4">
  <div>
    <slot :dataname="pLanguages" >
      <ul>
        <li v-for="item in pLanguages">{{item}}</li>
      </ul>      
    </slot>
  </div>
</template>

<script src='./vue.js'></script>
<script>
    const d = new Vue({
        el : '#d',
        data : {
          isShow : true
        },
        methods : {},
        computed : {},
        components : {
          cpn4 : {
            template : '#cpn4',
            data(){
              return {
                pLanguages: ['JavaScript', 'Python', 'Swift', 'Go', 'C++']
              }
            }
          }
        }
    })
</script>