Vue组件化开发-插槽的使用详解

文章目录

- Vue组件化-插槽

Vue组件化-插槽

1.插槽基本介绍

在开发中，我们会经常封装一个个可复用的组件：

前面我们会通过props传递给组件一些数据，让组件来进行展示；
但是为了让这个组件具备更强的通用性，我们不能将组件中的内容限制为固定的div、span等等这些元素；
比如某种情况下我们使用组件，希望组件显示的是一个按钮，某种情况下我们使用组件希望显示的是一张图片；
我们应该让使用者可以决定某一块区域到底存放什么内容和元素；

举个栗子：假如我们定制一个通用的导航组件 – NavBar

这个组件分成三块区域：左边-中间-右边，每块区域的内容是不固定；

左边区域可能显示一个菜单图标，也可能显示一个返回按钮，可能什么都不显示；

中间区域可能显示一个搜索框，也可能是一个列表，也可能是一个标题，等等；

右边可能是一个文字，也可能是一个图标，也可能什么都不显示；

这个时候我们就可以来定义插槽slot：

插槽的使用过程其实是抽取共性、预留不同；
我们会将共同的元素、内容依然在组件内进行封装；
同时会将不同的元素使用slot作为占位，让外部决定到底显示什么样的元素；

如何使用slot呢？

Vue中将 <slot> 元素作为承载分发内容的出口；
在封装组件中，使用特殊的元素<slot>就可以为封装组件开启一个插槽；
该插槽插入什么内容取决于父组件如何使用；

2.插槽基本使用

例如我们定义如下一个子组件

<template>
  <div class="show-message">
    <h2>{{ title }}</h2>
    <p>{{ content }}</p>
  </div>
</template>

<script>
  export default {
    props: {
      title: {
        type: String,
        default: ""
      },
      content: {
        type: String,
        default: ""
      }
    }
  }
</script>

我们在父组件中使用这个子组件的时候, 虽然可以改变内容, 但是h2元素和p元素是固定的

<template>
  <div class="app">
		<!-- 可以改变展示内容, 无法改变展示的元素 -->
    <show-message title="哈哈哈哈" content="我是内容1"></show-message>
    <show-message title="呵呵呵呵" content="我是内容2"></show-message>
    <show-message title="嘿嘿嘿嘿" content="我是内容3"></show-message>
  </div>
</template>

<script>
  import ShowMessage from './ShowMessage.vue'

  export default {
    components: {
      ShowMessage
    }
  }
</script>

但是我们确实想要更改元素的话, 就需要使用到插槽, 例如: 将p元素改为使用其他元素进行展示

在子组件中插入插槽

<template>
  <div class="show-message">
    <h2>{{ title }}</h2>
    
    <!-- 使用插槽 -->
    <slot></slot>
  </div>
</template>

插槽部分想要展示什么内容由父元素进行决定, 如果插槽没有插入东西, 那么这个插槽会被忽略

<template>
  <div class="app">
    <!-- 内容是p元素展示 -->
    <show-message title="哈哈哈哈">
      <p>我是内容1</p>
    </show-message>

		<!-- 内容是button元素展示 -->
    <show-message title="呵呵呵呵">
      <button>我是内容2</button>
    </show-message>
    
		<!-- 内容是h2元素展示 -->
    <show-message title="嘿嘿嘿嘿">
      <h3>我是内容3</h3>
    </show-message>
  </div>
</template>

效果如下 :

3.插槽默认内容

有时候我们希望在使用插槽时，如果没有插入对应的内容，那么我们需要显示一个默认的内容：

当然这个默认的内容只会在没有提供插入的内容时，才会显示；

我们可以在<slot>标签中设置一个默认内容

<template>
  <div class="show-message">
    <h2>{{ title }}</h2>

    <!-- 为插槽设置默认内容 -->
    <slot>
      <p>我是默认内容</p>
    </slot>
  </div>
</template>

当我们没有使用插槽时, 没有插入对象内容时, 就会展示默认内容

<template>
  <div class="app">
    <!-- 没有插入内容 -->
    <show-message title="嘿嘿嘿嘿"></show-message>
  </div>
</template>

效果如下:

4.多个插槽效果

还是通过一个简单案例分析, 例如我们做一个导航栏, 有如下一个子组件在父组件中展示

由于左, 中, 右三个部分都是不顾定的, 所以我们使用三个插槽, 并给插槽默认值

<template>
  <div class="nav-bar">
    <div class="left">
      <slot>left</slot>
    </div>

    <div class="content">
      <slot>content</slot>
    </div>

    <div class="right">
      <slot>right</slot>
    </div>
  </div>
</template>

<script>
  export default {}
</script>

<style scoped>
  .nav-bar {
    display: flex;
    height: 44px;
    line-height: 44px;
    text-align: center;
  }

  .left {
    width: 70px;
    background-color: aquamarine;
  }

  .content {
    flex: 1;
    background-color: skyblue;
  }

  .right {
    width: 70px;
    background-color: pink;
  }
</style>

默认情况下, 展示效果如图:

此时我们想要在父组件中, 分别对三个插槽插入内容, 此时组件中含有多个插槽，我们插入多个内容时是什么效果？

<template>
  <div class="app">
    <nav-bar>
      <button>返回</button>
      <span>内容</span>
      <a href="#">登录</a>
    </nav-bar>
  </div>
</template>

我们会发现默认情况下每个插槽都会获取到我们插入的内容来显示；

此时我们发现, 上面操作是无法完成我们的需求, 此时就需要具名插槽

5.具名插槽使用

事实上，我们希望达到的效果是插槽对应内容的显示，这个时候我们就可以使用具名插槽：

具名插槽顾名思义就是给插槽起一个名字，<slot> 元素有一个特殊的 attribute：name；
一个不带 name 的slot，会带有隐含的名字 default；

也就是说, 我们可以给每个插槽都取上一个名字, 如下 :

<template>
  <div class="nav-bar">
    <div class="left">
      <slot name="left">left</slot>
    </div>

    <div class="content">
      <slot name="content">content</slot>
    </div>

    <div class="right">
      <slot name="right">right</slot>
    </div>
  </div>
</template>

在父组件中使用的时候, 需要包裹一个<template>标签, 并在<template>中使用v-solt: 插槽名

<template>
  <div class="app">
    <nav-bar>
      <!-- 包裹template并使用v-slot找到对应的插槽 -->
      <template v-slot:left>
        <button>返回</button>
      </template>

			<!-- 包裹template并使用v-slot找到对应的插槽 -->
      <template v-slot:content>
        <span>内容</span>
      </template>
      
			<!-- 包裹template并使用v-slot找到对应的插槽 -->
      <template v-slot:right>
        <a href="#">登录</a>
      </template>
    </nav-bar>
  </div>
</template>

这样就可以明确的找到对应的插槽, 得到我们想要的效果

具名插槽使用的时候缩写：

跟 v-on 和 v-bind 一样，v-slot 也有缩写；
即把参数之前的所有内容 (v-slot:) 替换为字符 #；

<template>
  <div class="app">
    <nav-bar>
      <template #left>
        <button>返回</button>
      </template>

      <template #content>
        <span>内容</span>
      </template>
      
      <template #right>
        <a href="#">登录</a>
      </template>
    </nav-bar>
  </div>
</template>

6.动态插槽名称

什么是动态插槽名呢？

目前我们使用的插槽名称都是固定的；
比如 v-slot:left、v-slot:center等等；
我们可以通过 v-slot:[dynamicSlotName]方式动态绑定一个名称；

<template>
  <div class="app">
		<!-- 设置动态插槽名, 插槽名称又name这个变量动态控制 --> 
    <nav-bar v-slot:[name]>
      <a href="#">注册</a>
    </nav-bar>
  </div>
</template>

7.作用域插槽(难点)

但是有时候我们希望插槽可以访问到子组件中的内容是非常重要的：

当一个组件被用来渲染一个数组元素时，我们使用插槽，并且希望插槽中没有显示每项的内容；
这个Vue给我们提供了作用域插槽；

我们来看下面这个案例, 父组件传递数据给子组件

<template>
  <div class="app">
    <show-data :titles="titles"></show-data>
  </div>
</template>

<script>
  import ShowData from './ShowData.vue'

  export default {
    components: {
      ShowData
    },
    data() {
      return {
        titles: [
          "我是标题1",
          "我是标题2",
          "我是标题3"
        ]
      }
    },
  }
</script

子组件接收数据并进行展示, 但是展示的内容只能是h2

<template>
  <div show-data>
    <div v-for="(item, index) in titles" :key="index">
      <h2>{{ item }}</h2>
    </div>
  </div>
</template>

<script>
  export default {
    props: {
      titles: {
        type: Array,
      }
    }
  }
</script>

如果我们确实想替换h2使用其他元素该怎么做呢? 直接使用插槽的话, 会让我们数据固定, 不能动态展示, 这时候就需要用到作用域插槽

子组件中在插槽中传递出要使用的数据

<template>
  <div show-data>
    <div v-for="(item, index) in titles" :key="index">
      <!-- 包裹一个插槽, 通过插槽将子组件的数据传递给父组件 -->
      <!-- 可以传递多个数据 -->
      <slot :item="item" abc="abc">
        <h2>{{ item }}</h2>
      </slot>
    </div>
  </div>
</template>

父组件使用v-slot:插槽名=接收数据变量名来进行接收, 此时可以将h2元素换成其他元素进行替换

<template>
  <div class="app">
    <show-data :titles="titles" >
      <!-- 接收传递过来的数据 -->
      <template v-slot:default="props">
        <!-- 将h2元素替换为button, 并展示传递过来的数据 -->
        <button>{{ props.item }}</button>
      </template>
    </show-data>
  </div>
</template>

独占默认插槽的缩写

如果我们的插槽是默认插槽default, 且只有一个默认插槽，那么在使用的时候 v-slot:default="props"可以简写为v-slot="props"：

<!-- 独占默认插槽缩写 -->
<template v-slot="props">
  <button>{{ props.item }}</button>
</template>

文章由极客之音整理，本文链接：https://www.bmabk.com/index.php/post/120083.html