Vue插槽(slot)详解与使用方法

简介: Vue插槽(slot)详解与使用方法

插槽:简单理解就是组件内部留一个或多个的插槽位置,可供组件传对应的模板代码进去。插槽的出现,让组件变的更加灵活。

1. 匿名插槽

父组件

// home.vue
<template>
  <div class="home">
    <footerComponent>
      <p>我是匿名插槽</p>
    </footerComponent>
  </div>
</template>
<script>
import footerComponent from '@/components/footerComponent.vue'
export default {
  components: {
    footerComponent,
  }
}
</script>

子组件

// footerComponent.vue
<template>
  <div>
    <h1>子组件</h1>
    <slot></slot> //  替换为 <p>我是匿名插槽</p>
  </div>
</template>

2020062310470442.png

1.2 后备内容

有时为一个插槽设置具体的后备 (也就是默认的) 内容是很有用的,它只会在没有提供内容的时候被渲染。

父组件

// home.vue
<template>
  <div class="home">
    <footerComponent></footerComponent>
  </div>
</template>
<script>
import footerComponent from '@/components/footerComponent.vue'
export default {
  components: {
    footerComponent,
  }
}
</script>

子组件

// footerComponent.vue
<template>
  <div>
    <h1>子组件</h1>
    <slot>
      <p>我是后补内容</p>
    </slot>
  </div>
</template>

2020062310470442.png

2. 具名插槽

顾名思义就是带名字的插槽,假如需要在组件内部预留多个插槽位置,就需要为插槽定义名字,指定插入的位置。

Vue 2.6.0+ 版本,使用v-slot替代slot 和 slot-scope。

注意点:

1.具名插槽的内容必须使用模板< template ></ template >包裹;

2.不指定名字的模板插入匿名插槽中,推荐使用具名插槽,方便代码追踪且直观清楚;

3.匿名插槽具有隐藏的名字"default;"

2.1 具名插槽的缩写

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

例如 v-slot:header 可以被重写为 #header;

然而,和其它指令一样,该缩写只在其有参数的时候才可用。这意味着以下语法是无效的:

// 这样会触发一个警告 
<current-user #="{ user }">
  {{ user.firstName }}
</current-user>

如果你希望使用缩写的话,你必须始终以明确插槽名取而代之:

<current-user #default="{ user }">
  {{ user.firstName }}
</current-user>

2.2 动态插槽名

动态指令参数也可以用在 v-slot 上,来定义动态的插槽名

<base-layout>
  <template v-slot:[dynamicSlotName]>
    ...
  </template>
</base-layout>

父组件

// 现在 <template>元素中的所有内容都将会被传入相应的插槽。
// 任何没有被包裹在带有 v-slot 的 <template> 中的内容都会被视为默认插槽的内容。
<template>
  <div class="home">
    <footerComponent>
      <template v-slot:header>
        <h2>header</h2>
      </template>
      <template v-slot:[mybody]>
        <h3>动态插槽名</h3>
      </template>
      <p>内容</p>
      <template #footer>
        <h2>footer</h2>
      </template>
    </footerComponent>
  </div>
</template>
<script>
import footerComponent from '@/components/footerComponent.vue'
export default {
  data(){
    return{
      mybody:'body',
    }
  },
  components: {
    footerComponent,
  }
}
</script>

子组件

<template>
  <div class="footerComponent">
    <h1>子组件</h1>
    <slot name="header"></slot>
    <slot name="body"></slot>
    <slot><p>我是后补内容</p></slot>   //  等价于 <slot name="default"></slot>
    <slot name="footer"></slot>
  </div>
</template>
<style scoped lang="stylus">
.footerComponent
  width 100%
  height 200px
  background-color pink
</style>

2020062310470442.png

3. 作用域插槽

3.1 父传子

父组件

<template>
  <div class="home">
    <headerComponent :title="myName">
      <template #header>
        <h2>父组件</h2>
      </template>
    </headerComponent>
  </div>
</template>
<script>
import headerComponent from '@/components/headerComponent.vue'
export default {
  data(){
    return{
      myName:'我是',
    }
  },
  components: {
    headerComponent,
  }
}
</script>

子组件

<template>
  <div class="headerComponent">
    <slot name="header"></slot>
  <div class="childName">{{title}}子组件</div>
  </div>
</template>
<script>
export default {
  props: {
    title:String
  }
}
</script>
<style scoped lang="stylus">
.childName
  color red
  font-size 20px
</style>

2020062310470442.png

父组件传递的插槽内容是由子组件编译的,插槽作用域由子组件决定。

所以如果需要动态修改插槽的内容,就需要子组件传参给父组件。

3.2 子传父

父组件传参给子组件,props接收后,插槽slot再通过绑定属性传递参数返回给父组件,不管是模板代码还是数据,控制权完全掌握在父组件手里。

第一种方式

父组件

<template>
  <div class="home">
    <footerComponent :myLayout="layout">
      <template v-slot:header="headerSlotProps">
        <h2>{{headerSlotProps.header}}</h2>
      </template>
      <template v-slot="slotProps">
        <p>{{slotProps.content}}</p>
      </template> 
      <template #footer="slotProps">
        <h2>{{slotProps.footer}}</h2>
      </template>
    </footerComponent>
  </div>
</template>
<script>
import footerComponent from '@/components/footerComponent.vue'
export default {
  data(){
    return{
      layout:{
        header:'头部',
        content:'内容',
        footer:'脚部'
      },
    }
  },
  components: {
    footerComponent
  }
}
</script>

子组件

<template>
  <div class="footerComponent">
    <h1>子组件</h1>
    <slot name="header" :header="myLayout.header"></slot>
    <slot :content="myLayout.content"><p>我是后补内容</p></slot>
    <slot name="footer" :footer="myLayout.footer"></slot>
  </div>
</template>
<script>
export default {
  props: {
    myLayout:Object
  }
}
</script>
<style scoped lang="stylus">
.footerComponent
  width 100%
  height 250px
  background-color pink
</style>

2020062310470442.png

第二种方式
子组件通过属性 <slot :自定义属性名 = '值'></slot>,将自己内部的原始类型给到父组件;
父组件 <template slote-scope='自定义接收'></template>;
子组件 slot 除了要占个位置还要传递参数,父组件 slote-scope 负责接收参数;

父组件

<template>
  <div class="home">
    <childComponent :list="provinces">
      <template slot-scope="slotProps">
        <h4 v-for="city in slotProps.cities" :key="city.id" >
          城市: {{city.name}}
        </h4>
      </template>
    </childComponent>
  </div>
</template>
<script>
import childComponent from './itemComponent.vue'
export default {
  data(){
    return{
      provinces:[
        {
          id:1,
          name:'江苏',
          cities:[
            {id:11,name:'南京'},
            {id:12,name:'苏州'}
          ]
        },{
          id:2,
          name:'湖北',
          cities:[
            {id:21,name:'武汉'},
            {id:22,name:'鄂州'}
          ]
        },
      ]
    }
  },
  components: {
    childComponent
  }
}
</script>
-------------------------第一种方式实现,其余部分不变-------------------------------
<template>
  <div class="home">
    <childComponent :list="provinces">
      <template v-slot="slotProps">
        <h4 v-for="city in slotProps.cities" :key="city.id" >
          城市: {{city.name}}
        </h4>
      </template>
    </childComponent>
  </div>
</template>

子组件

<template>
  <div class="footerComponent">
    <div v-for="item in list" :key="item.id">
      <h2>省份:{{item.name}}</h2> 
      <slot :cities="item.cities"></slot>
    </div>
  </div>
</template>
<script>
export default {
  props: {
    list:{
      type: Array,
      default: function(){
        return []
      }
    }
  }
}
</script>

image.png

参考文章(侵删)





相关文章
|
3天前
|
JavaScript
vue3- antd design vue 引入iconfont
vue3- antd design vue 引入iconfont
|
2天前
|
JavaScript API
vue尚品汇商城项目-day04【24.点击搜索按钮跳转后的页面商品列表、平台售卖属性动态展示(开发Search组件)】
vue尚品汇商城项目-day04【24.点击搜索按钮跳转后的页面商品列表、平台售卖属性动态展示(开发Search组件)】
14 1
vue尚品汇商城项目-day04【24.点击搜索按钮跳转后的页面商品列表、平台售卖属性动态展示(开发Search组件)】
|
1天前
|
JavaScript 前端开发
vue尚品汇商城项目-day01【4.完成非路由组件Header与Footer业务】
vue尚品汇商城项目-day01【4.完成非路由组件Header与Footer业务】
9 2
|
1天前
|
JavaScript 前端开发
vue尚品汇商城项目-day01【3.项目路由的分析】
vue尚品汇商城项目-day01【3.项目路由的分析】
6 1
|
2天前
|
JavaScript 数据格式
vue3 + Ant design vue formItem 无法使用嵌套的form表单校验
vue3 + Ant design vue formItem 无法使用嵌套的form表单校验
16 1
|
2天前
|
JavaScript
vue尚品汇商城项目-day03【23.把首页当中的轮播图拆分为一个共用的全局组件】
vue尚品汇商城项目-day03【23.把首页当中的轮播图拆分为一个共用的全局组件】
10 2
|
1天前
|
JavaScript 前端开发 数据安全/隐私保护
vue尚品汇商城项目-day01【5.路由组件的搭建】
vue尚品汇商城项目-day01【5.路由组件的搭建】
5 0
vue尚品汇商城项目-day01【5.路由组件的搭建】
|
2天前
|
JavaScript 索引
vue尚品汇商城项目-day04【25.面包屑处理关键字】
vue尚品汇商城项目-day04【25.面包屑处理关键字】
12 1
|
2天前
|
JavaScript 前端开发 API
vue尚品汇商城项目-day04【28.详情页面Detail】
vue尚品汇商城项目-day04【28.详情页面Detail】
10 1
|
2天前
|
JavaScript 索引
vue尚品汇商城项目-day04【27.分页器静态组件(难点)】
vue尚品汇商城项目-day04【27.分页器静态组件(难点)】
10 1