在 Vue 中更优雅的封装第三方组件-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 组件加载过程以及加载出错的效果。

GIF 2022-4-15 15-58-13.gif

二、关键技术点介绍

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>