Vue一个案例引发「内容分发slot」的最全总结
今天我们继续来说说 Vue,目前一直在自学 Vue 然后也开始做一个项目实战,我一直认为在实战中去发现问题然后解决问题的学习方式是最好的,所以我在学习一些 Vue 的理论之后,就开始自己利用业余时间做了一个项目,然后通过项目中的一些案例进行总结。
今天我们来说说 Vue 中的内容分发 <slot>
,首先 Vue 实现了一套内容分发的 API,这套 API 是基于当前的 Web Components 规范草案,将 <slot>
元素作为承载内分发内容的出口,内容分发是 Vue 中一个非常重要的功能,很多第三方的框架库都使用到了<slot>
功能,所以掌握这个技能是非常重要的。
它可以让我们更加优雅的使用组件。
我对 <slot>
的理解有三点或者说优势,当然,这个只是我个人的理解,如果你有不同理解的地方,欢迎交流讨论,这样才能碰出不一样的花火。
回到主题,我对内容分发的三点理解:
- 可以优雅的包装原生的 HTML 标签
- 组件标签可以嵌套,就像使用原生 HTML 标签一样
- 让组件更加的通用和可复用
如果没有 <slot>
元素,当我们在组件的标签中使用组件标签或者组件标签中使用 HTML 原生标签,都是没有任何作用的,这个和我们以往使用和认识的 HTML 是相违背的。
下面我们就对这三点去做一个详细的阐述,先从一个张图开始。
这个大家都见过,一个标准的 dialog 对话框,项目中也经常使用到,我们把它抽出来做成一个组件如下:
<div class="dialog-panel">
<div class="dialog-header">
<h3 class="title">标题</h3>
<button class="close">x</button>
</div>
<div class="dialog-content">这是一个标准的 dialog 对话框</div>
<div class="dialog-footer">
<el-button type="primary" plain>取消</el-button>
<el-button type="primary">确定</el-button>
</div>
</div>
首先这个组件不够灵活,内容基本上是写死的,就拿标题来说,我们希望标题是可以变化的,让使用者可以传递标题进来,那么我们该如何去设计我们的这个组件呢?这就是我们今天要说的内容分发 <slot>
了,我们小小的修改下我们的例子。
<div class="dialog-panel">
<slot></slot>
<div class="dialog-content">这是一个标准的 dialog 对话框</div>
<div class="dialog-footer">
<el-button type="primary" plain>取消</el-button>
<el-button type="primary">确定</el-button>
</div>
</div>
在父组件中使用它
<dialog-panel>
<div class="dialog-header">
<h3 class="title">传递进来的标题</h3>
<button class="close">x</button>
</div>
</dialog-panel>
你会发现组件渲染之后,<slot>
元素会被替换成组件中包裹的元素,标题的内容完全由外部传递进来。
上面我们只是嵌套了一个简单的 div 标签元素,插槽可以传入任何的元素,不管是HTML,还是组件元素。
插槽的默认内容
不仅如此,插槽还支持默认内容,当我们在外部没有传递给插槽内容时,我们可以给插槽一个默认的显示内容,如果外部有内容,默认的内容将会被外部的内容替换掉。
<div class="dialog-panel">
<slot>
<div class="dialog-header">
<h3 class="title">这是默认标题</h3>
<button class="close">x</button>
</div>
</slot>
<div class="dialog-content">这是一个标准的 dialog 对话框</div>
<div class="dialog-footer">
<el-button type="primary" plain>取消</el-button>
<el-button type="primary">确定</el-button>
</div>
</div>
在父组件中使用它,不嵌套任何的内容时,我们的组件就会有个默认的渲染标题。
<dialog-panel>
//无内容
</dialog-panel>
如果我们在父组件中提供了内容,默认的内容就会被替换。
<dialog-panel>
<div class="dialog-header">
<h3 class="title">我是新传递的标题</h3>
<button class="close">x</button>
</div>
</dialog-panel>
具名插槽
有些时候,我们除了标题有这么高的自由度之外,我们也想其它的内容也有这样的灵活性,让使用者也能通过父组件传递进来,Vue 中给我们提供了方法,我们一次可以使用很多插槽,然后给每一个插槽起个名字,也就是给我们的 <slot>
添加一个 name 属性。
于是我们就开始修改我们的对话框
<div class="dialog-panel">
<slot name="header"></slot>
<slot name="content"></slot>
<slot name="footer"></slot>
</div>
我们在外部使用时,只需要提供相应名称,我们就可以渲染出我们需要的
<dialog-panel>
<template slot="header">
<div class="dialog-header">
<h3 class="title">带名字的插槽</h3>
<button class="close">x</button>
</div>
</template>
<template slot="content">
<div class="dialog-content">这是一个标准的 dialog 对话框</div>
</template>
<template slot="footer">
<div class="dialog-footer">
<el-button type="primary" plain>取消</el-button>
<el-button type="primary">确定</el-button>
</div>
</template>
</dialog-panel>
可以看到,我们在外部可以控制组件的全部内容只要我们需要,这给我们的组件带来了很高的灵活性。除了灵活性,Vue 中还给我提供了一种叫 作用域插槽 的用法,它让我们的组件更加的复用性。
具名插槽不仅仅只能用在 <template>
元素上,它也可以直接用在一个普通的元素上
<div slot="header" class="dialog-header">
<h3 class="title">带名字的插槽</h3>
<button class="close">x</button>
</div>
作用域插槽
作用域插槽在 Vue 中是一个非常重要的一个功能,它让组件更加的可复用性,但是官方文档上对作用域插槽的解释很令人蛋疼,反正我是看了几遍不是太理解,最后通过自己写了几个案例才明白原来可以这么厉害,如果你也和我一样一开始不太理解,不妨跟着我看看下面的案例或许对你的帮助很大。
首先我们实现一个星级评价组件
<template>
<div class="rate-list">
<span
v-for="(star, index) in stars"
:key="index"
@click="clickStart(index)"
>
<i v-bind:class="[star ? off : on]"></i>
</span>
</div>
<template>
<script>
export default {
name: "RateList",
data() {
return {
off: "el-icon-star-off",
on: "el-icon-star-on",
rating: 2
};
},
methods: {
clickStart(index) {
this.rating = index + 1;
}
},
computed: {
stars() {
return [1, 2, 3, 4, 5].map(value => this.rating < value);
}
}
};
</script>
这是我们写死的一个星级评价组件,一直都用着还不错,可是突然有一天呢,产品说这个小星星用腻歪了能不能换个别的图标?我最近爱上了 ❤️ 形
所以用这个表示吧。到这里,你可能也想到了我们把这个图标给抽离出来,放在外部,所以我们结合上面刚刚学到的 <slot>
元素去修改组件。
<div class="rate-list">
<slot></slot>
</div>
在父组件中使用:
<rate-list>
<span
v-for="(star, index) in stars"
:key="index"
@click="clickStart(index)"
>
<i v-bind:class="[star ? off : on]"></i>
</span>
</rate-list>
完成之后呢,我们再也不怕以后更换内容的情况了,不管以后怎么换,我都可以在使用的时候直接在外部添加内容即可,但是似乎有一些问题,因为我们的代码看起来不是很优雅,而且我们把操作逻辑都放在的父组件中,这显然不太友好,最好的方式肯定是我们只需要在父组件中直接调用即可,所以作用域插槽这里就起到很大的作用了,我们来看看如果使用作用域插槽是如何保持优雅的。
<div class="rate-list">
<span
v-for="(star, index) in stars"
:key="index"
@click="clickStart(index)"
>
<slot :star="star"></slot>
</span>
</div>
在父组件中使用:
<rate-list>
<template slot-scope="props">
<i :class="[props.star ? off : on]"></i>
</template>
</rate-list>
可以看到我们把操作逻辑全部都放在了组件内部,在外部我们只需要添加需要的元素即可,简单优雅高复用性。
在 Vue2.5.0+,slot-scope 不再限制在 <template>
元素上使用,而可以用在插槽内的任何元素或组件上
有些同学看到这里可能还没有很好的理解作用域插槽,那好吧我就送佛送到西,咱继续看一个例子,我们创建一个列表面板组件。
<template>
<div class="list-box">
<h1>{{title}}</h1>
<ul>
<li v-for="(item, index) in list" :key="index">
<slot :item="item"></slot>
</li>
</ul>
</div>
</template>
<script>
export default {
name: "List",
props: {
title: String,
list: Array
}
};
</script>
在父组件中使用:
<template>
<div class="tirp-wrapper">
<list title="酒店列表" :list="list">
<span slot-scope="props">
{{props.item.name}}
</span>
</list>
</div>
</template>
<script>
import List from "./List";
export default {
name: "Trip",
components: { List },
data() {
return {
list: [{
name: "四季度假村酒店"
},{
name: "布宜诺斯艾利斯四季酒店"
},{
name: "孟买四季酒店"
},{
name: "新加坡四季酒店"
}]
};
}
};
</script>
我们再来给每个酒店添加一些描述标签,也能够完美的展示出来。
<template>
<div class="tirp-wrapper">
<list title="酒店列表" :list="list">
<div slot-scope="props">
<span>
{{props.item.name}}
</span>
<el-tag>{{props.item.tag}}</el-tag>
</div>
</list>
</div>
</template>
<script>
import List from "./List";
export default {
name: "Trip",
components: { List },
data() {
return {
list: [{
name: "四季度假村酒店",
tag: "海滨风光"
},{
name: "布宜诺斯艾利斯四季酒店",
tag: "轻奢度假"
},{
name: "孟买四季酒店",
tag: "服务周到"
},{
name: "新加坡四季酒店",
tag: "沙海绿洲"
}]
};
}
};
</script>
画风一转,下面我们把它变成一个消息通知列表,可以看到每个文章的点赞数量。
<template>
<div class="tirp-wrapper">
<list title="消息通知" :list="list">
<div slot-scope="props">
<span>
{{props.item.title}}
</span>
<el-badge :value="props.item.value" :max="99">
<el-button size="mini">
<i class="fa fa-thumbs-o-up"></i>
</el-button>
</el-badge>
</div>
</list>
</div>
</template>
<script>
import List from "./List";
export default {
name: "Trip",
components: { List },
data() {
return {
list: [{
title: "Vue一个案例引发「动画」的使用总结",
value: 200
},{
title: "Vue一个案例引发的递归组件的使用",
value: 20
},{
title: "Vue一个案例引发的动态组件与全局事件绑定总结",
value: 50
}]
};
}
};
</script>
可以看到,不管我们如何的去修改数据结构也好,添加不同的内容也罢,我们都可以完美的完成,而且不用修改我们的子组件,只需要在外部调用时填充我们需要的内容即可。
有没有感受到作用于插槽的强大与灵活。
如果用一句话来描述作用域插槽的话:它可以让我们在父组件中访问子组件的数据,就像利用 props 属性让子组件访问到父组件的数据一样。
总结
插槽是一个重要且非常强大的功能,它可以让我们的组件具有非常 的灵活性与可复用性,而作用域插槽更加的强化了这些特性。
作用域插槽是一个不太好理解的地方,希望通过本篇文章能够让你解惑。
如果你觉得本文对你有帮助,欢迎转发,点赞,不足之处欢迎指正!
关注我的微信公众号:六小登登,更多干货文章,欢迎一起交流。
人人都可以成为高手。我是一个会技术,又写干货的码农。欢迎勾搭。