在 Vue 中更优雅的封装第三方组件
一、需求场景描述
实际开发的时候,为了减少重复造轮子,提高工作效率,节省开发时间成本, 免不了会使用ui组件库,比如在web前端很受欢迎的element-ui。但有的时候,我们需要在原组件的基础上做些改造,比如一个image组件, 我们需要统一在图片加载失败的时候展示的特定图,每次使用组件都加一遍, 麻烦耗时,关键是维护成本高,当需要更新这个加载出错的图片时, 得再次一个个去找到使用该组件的地方修改。
再例如自定义分页组件也很常见,组件的样式,默认支持的每页数目, 封装之后再用,在可维护性和开发效率上都很有好处。
然而也不至于从0开始写一个分页组件,在原有基础上封装就好, 那么如何快速优雅的封装一个第三方组件库的组件呢?v-bind=attrs
和v−on=attrs
和v-on=attrs
和v−on=listeners=$listeners
,会给我们带来惊喜。它们可以使得封装后的组件, “继承”原组件的几乎所有v-bind
属性和v-on
事件,且用法和作用与在原组件一样。
封装el-image
为custom-image
组件,所有使用custom-image
展示图片的地方, 图片加载过程中都会统一展示“加载中...”的提示,且当加载出错时,会展示统一的默认图。下面是一个custom-image
组件加载过程以及加载出错的效果。
二、关键技术点介绍
1.v-bind=$attrs
v-bind=$attrs
的妙用是在创建更高级别的组件,在封装第三方组件时,
可以自动将在父作用域中使用的v-bind
的属性自动绑定,
并向下传入被封装的使用了v-bind=$attrs
的组件。
一段摘自vue官网的介绍
包含了父作用域中不作为prop被识别 (且获取) 的attribute, 绑定 (class和style除外)。当一个组件没有声明任何prop时, 这里会包含所有父作用域的绑定 (class和style除外), 并且可以通过v-bind=$attrs
传入内部组件——在创建高级别的组件时非常有用。
例如我们封装的custom-Image
组件,使用了v-bind=$attrs
之后,我们在custom-Image
组件中,也拥有了el-image
的几乎所有属性, 而且其作用效果和用法,是和我们使用el-image
是一样的,也就说我们可以看着el-image
的文章去使用custom-Image
。
2.v-on=$listeners
v-on=listeners
的作用和用法与v−bind=listeners
的作用和用法与v-bind=listeners
的作用和用法与v−bind=attrs
类似,它可以将父作用域中的使用v-on
的时间监听器向下传入到使用了v-on=listeners
组件中,和v−bind=listeners
组件中,和v-bind=listeners
组件中,和v−bind=attrs
的功效类似,只不过一个属性一个是事件。还是custom-Image
组件为例,这时候custom-Image
组件就拥有了el-image
组件的几乎所有事件。而且其作用效果和用法,是和我们使用el-image
是一样的。
包含了父作用域中的 (不含.native
修饰器的)v-on
事件监听器。
它可以通过v-on=$listeners
传入内部组件——在创建更高层次的组件时非常有用。
一段摘自 vue 官网的介绍
三、封装el-image的代码示例
使用custom-Image
组件的示例
<custom-Image fit=fill class=icon-img :src=picPreview(expert)></custom-Image> 封装el-image为custom-Image组件的示例 <template> <div id=CustomImage> <el-image v-bind=$attrs v-on=$listeners> <div slot=error class=image-slot> <img :src=require('image-f/icon-empty-img.png') alt=图片加载失败.png/> </div> <div slot=placeholder class=placeholder-slot>加载中...</div> </el-image> </div> </template> <script> export default { name: 'CustomImage' } </script> <style scoped lang=scss> #CustomImage { .image-slot { text-align: center; } .placeholder-slot { text-align: center; } } </style>
