13《Vue 入门教程》Vue 插槽的使用

1. 前言

本小节我们将介绍如何使用插槽slot,包括默认插槽、具名插槽、作用域插槽。插槽可以使组件的模版变得多样性,让用户在使用组件时可以自定义传入模版内容。在复杂组件中,当我们在使用多个插槽的时候将会是一个难点。但是也不必担心,只要我们将每个插槽类型的使用方法学透,相信面对任何复杂插槽的使用的时候都可以游刃有余。

2. 木子解释

Vue 实现了一套内容分发的 API,将 元素作为承载分发内容的出口。 —— 官方定义

<slot>元素作为承载分发内容的出口,可以理解为一个占位符,或者说是子组件暴露的一个让父组件传入自定义内容的接口。插槽内可以包含任何模板代码,包括 HTML,甚至其他的组件。在工作中如果你的组件内的内容是可变的,这个时候我们可以考虑使用插槽。

3. 插槽的类型

<slot>有三种类型,他们分别是:

  • 默认插槽 default
  • 具名插槽 name
  • 作用域插槽 v-slot

接下来,我们将一步步介绍这三种不同插槽的使用方式。

3.1 默认插槽的使用

在自定义组件中使用<slot />标签进行占位,当我们使用该组件时,在组件标签内写入需要展示的具体内容:

{
  components: {
    'MyConponent': {
      template: '<div><slot /></div>'
    }
  }
}
<my-conponent>这里是要显示的插槽内容!</my-conponent>

我们用一个简单的示例来学习以下如何使用默认插槽:

实例演示

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <meta http-equiv="X-UA-Compatible" content="ie=edge">
  <title>Document</title>
</head>
<body>
  <div id="app">
    <my-component>
      句号
    </my-component>
  </div>
</body>
<script src="https://unpkg.com/vue/dist/vue.js"></script>
<script type="text/javascript">
  Vue.component('myComponent', {
    template: '<div>Hello !<slot></slot></div>'
  })
  var vm = new Vue({
    el: '#app',
    data() {
        return {}
    }
  })
</script>
</html>


"运行案例" 可查看在线运行效果

代码解释:
在 JS 代码第 3-5 行,我们通过 Vue.Component 注册了全局组件 myComponent,并在组件内部使用了默认插槽 slot,在 html 中使用插槽(代码 2-4 行),并在标签内传入组件内需要展示的插槽内容。

3.2 具名插槽的使用

具名插槽就是给<slot />标签加上 name 属性。语法:<my-component><slot name="插槽名字"/></my-component>

{
  components: {
    'MyConponent': {
      template: '<div><slot name="hello"/></div>'
    }
  }
}
<my-conponent>
  <template slot="hello"></template>
</my-conponent>

我们用一个简单的示例,来学习一下如何使用具名插槽:

实例演示

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <meta http-equiv="X-UA-Compatible" content="ie=edge">
  <title>Document</title>
</head>
<body>
  <div id="app">
    <my-component>
      <span slot="name">句号</span>
      <span slot="time">2020-02-02</span>
    </my-component>
  </div>
</body>
<script src="https://unpkg.com/vue/dist/vue.js"></script>
<script type="text/javascript">
  Vue.component('myComponent', {
    template: '<div>Hello !<slot name="name"></slot> <slot name="time"></slot></div>'
  })
  var vm = new Vue({
    el: '#app',
    data() {
        return {}
    }
  })
</script>
</html>


"运行案例" 可查看在线运行效果

代码解释:
在 JS 代码第 4-6 行,我们通过 Vue.Component 注册了全局组件 myComponent,并在组件内部使用了两个具名插槽 name 和 time,在 html 中使用具名插槽(代码 2-5 行),并在标签内传入组件需要展示的插槽内容。

3.3 作用域插槽的使用

有时候,我们在父组件使用插槽时需要访问子组件中的数据,这时候就需要使用作用域插槽。用法:将 data 变量名 作为 <slot> 元素的一个 attribute 绑定上去:

<slot :[自定义变量名]="[需要传入的数据]"></slot>
<!-- 示例 -->
<slot :count="count"></slot>
```,
在使用组件时,通过`v-slot:插槽名字="数据别名"`的方式使用。
```html
<!-- 默认插槽中使用作用域插槽 -->
<my-component>
  <template v-slot:default="slotProps">
    {{slotProps.count}}
  </template>
</my-component>

<!-- 具名插槽中使用作用域插槽 -->
<my-component>
  <template v-slot:插槽名字="slotProps">
    {{slotProps.count}}
  </template>
</my-component>

下面我们通过两个例子详细介绍,如何在默认插槽和具名插槽中,使用作用域插槽。

3.3.1 默认插槽中使用作用域插槽

对于默认插槽我们可以省略v-slot后面的插槽名,直接使用v-slot="数据别名"的方式:
示例:

实例演示

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <meta http-equiv="X-UA-Compatible" content="ie=edge">
  <title>Document</title>
</head>
<body>
    <div id="app">
        <my-component>
          <!-- 使用 v-slot 接收默认插槽的数据,并把数据命名为  slotProps-->
          <template v-slot:default="slotProps">
            <br />
            <!-- 使用 插槽数据-->
            我叫:{{slotProps.detail.name}},我的爱好是:{{slotProps.detail.love}}
          </template>
        </my-component>
        <my-component>
          <!-- 默认插槽可以忽略v-slot后面的插槽名-->
          <template v-slot="slotProps">
            <br />
            <!-- 使用 插槽数据-->
            我叫:{{slotProps.detail.name}},我的爱好是:{{slotProps.detail.love}}
          </template>
        </my-component>
      </div>
</body>
<script src="https://unpkg.com/vue/dist/vue.js"></script>
<script type="text/javascript">
  Vue.component('myComponent', {
    // 在默认插槽中传入数据 detail
    template: '<div>Hello !<slot :detail="detail"></slot></div>',
    data() {
      return {
        detail: {
          name: '句号',
          love: 'coding'
        }
      }
    }
  })
  var vm = new Vue({
    el: '#app',
    data() {
        return {}
    }
  })
</script>
</html>


"运行案例" 可查看在线运行效果

代码解释:
在 JS 代码第 3-14 行,我们通过 Vue.Component 注册了全局组件 myComponent。

在 HTML 代码第 2-8 行,使用 v-slot:default=“数据别名” 的方式接收默认插槽的数据,并把数据命名为 slotProps。

在 HTML 代码第 9-16 行,使用 v-slot=“数据别名” 的方式接收默认插槽的数据(省略默认插槽名),并把数据命名为 slotProps。

3.3.2 具名插槽中使用作用域插槽

具名插槽必须在v-slot后面加上插槽名,否则数据无法在具名插槽中使用:
示例:

实例演示

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <meta http-equiv="X-UA-Compatible" content="ie=edge">
  <title>Document</title>
</head>
<body>
    <div id="app">
        <my-component>
          <!-- 使用 v-slot 接收具名插槽 detail 的数据,并把它命名为  slotProps-->
          <template v-slot:detail="slotProps">
            <br />
            <!-- 使用 插槽 detail 的数据-->
            我叫:{{slotProps.detail.name}},我的爱好是:{{slotProps.detail.love}}
          </template>
        </my-component>
    </div>
</body>
<script src="https://unpkg.com/vue/dist/vue.js"></script>
<script type="text/javascript">
  Vue.component('myComponent', {
    // 定义具名插槽 detail 并传入数据 detail
    template: '<div>Hello !<slot :detail="detail" name="detail"></slot></div>',
    data() {
      return {
        detail: {
          name: '句号',
          love: 'coding'
        }
      }
    }
  })
  var vm = new Vue({
    el: '#app',
    data() {
        return {}
    }
  })
</script>
</html>


"运行案例" 可查看在线运行效果

在 JS 代码第 3-14 行,我们通过 Vue.Component 注册了全局组件 myComponent。
在 HTML 代码第 2-8 行,使用 v-slot:default=“数据别名” 的方式接收默认插槽的数据,并把数据命名为 slotProps。

4. 小结

在本小节,我们介绍了组件中插槽的一些使用方法,主要有以下知识点:

  • 通过标签 使用默认插槽;
  • 通过给标签 添加一个 name 的 attribute 来命名插槽;
  • 通过作用域插槽 v-slot 让父组件可以访问到子组件中的数据。
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,911评论 5 460
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 82,014评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 142,129评论 0 320
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,283评论 1 264
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,159评论 4 357
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,161评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,565评论 3 382
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,251评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,531评论 1 292
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,619评论 2 310
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,383评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,255评论 3 313
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,624评论 3 299
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,916评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,199评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,553评论 2 342
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,756评论 2 335

推荐阅读更多精彩内容