插槽:简单理解就是组件内部留一个或多个的插槽位置,可供组件传对应的模板代码进去。插槽的出现,让组件变的更加灵活。
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>
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>
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>
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>
父组件传递的插槽内容是由子组件编译的,插槽作用域由子组件决定。
所以如果需要动态修改插槽的内容,就需要子组件传参给父组件。
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>
第二种方式
子组件通过属性 <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>