手把手带你封装一个vue component第三方库


Posted in Javascript onFebruary 14, 2019

为什么选择自己封装第三方库

最近几个月我司把之前两三年的所有业务都用了 vue 重构了一遍,前台使用 vue+ssr,后台使用了 vue+element,在此过程中封装和自己写了很多 vue component。其实vue 写 component 相当简单和方便,github上有很多的 vue component 都只是简单的包装了一些 jquery 或者原生 js 的插件,但我个人是不太喜欢使用这些第三方封装的。理由如下:

  1. 很多第三方封装的组件参数配置项其实是有缺损的。如一些富文本或者图表组件,配置项远比你想想中的多得多,第三方封装组件很难覆盖全部所有配置。
  2. 第三方组件的更新频率很难保证。很多第三方封装组件并不能一直和原始组件保持同步更新速度,万一原始组件更新了某个你需要的功能,但第三方并没有更新那岂不是很尴尬,而且很多第三方组件维护一段时间之后就不维护了。
  3. 灵活性和针对性。还是那富文本来说,富文本在我司有很多定制化需求,我们需要将图片上传七牛,需要将图片打水印,需要很多针对业务的特殊需求,使用第三方包装的组件是不合适的,一般基于第三方封装的组件是很难拓展的。

所以我觉得大部分组件还是自己封装来的更为方便和灵活一些。

动手开干

接下来我们一起手摸手教改造包装一个js插件,只要几分钟就可以封装一个专属于你的 vue component。封装对象:countUp.js,改造后结果vue-countTo。

首先我们用官方提供的vue-cli 来构建项目 这里选择了 webpack-simple (组件相对而言比较简单,不需要很多复杂的功能,所以 webpack-simple 已经满足需求了)

$ npm install -g vue-cli
$ vue init webpack-simple my-project
$ cd my-project
$ npm install

安装countup.js

$ npm install countup.js
$ npm run dev

启动项目之后按照 countup.js 官方 demo 初始化插件

app.vue

<template>
 <span ref='countup'></span>
</template>

<script>
import CountUp from 'countup.js'
export default {
 name: 'countup-demo',
 data () {
  return {
   numAnim:null
  }
 },
 mounted(){
  this.initCountUp()
 },
 methods:{
  initCountUp(){
   this.numAnim = new CountUp(this.$refs.countup,0, 2017)
   this.numAnim.start();
  }
 }
}
</script>

刷新页面,就这么简单,countUp.js 已经生效了。

手把手带你封装一个vue component第三方库

接下来查看 countUp.js 的 github 发现它定义了如下可配置参数

手把手带你封装一个vue component第三方库

对应 vue 就是 props,类型和初始化一目了然。

props: {
 start: {
  type: Number,
  default: 0
 },
 end: {
  type: Number,
  default: 2017
 },
 decimal: {
  type: Number,
  default: 0
 },
 duration: {
  type: Number,
  default: 2.5
 },
 options: {
  type: Object
 }
}

之后再将countup之前写死的配置项替换为动态props就可以了

this.numAnim = new CountUp(this.$refs.countup, 
              this.start,
              this.end,
              this.decimal,
              this.duration,
              this.options)

使用组件

<vue-count-up :end="2500" :duration="2.5"></vue-count-up>

只要几分钟一个属于自己的原生组件就包装好了,就是这么简单。完整demo

这时候你如果觉得使用countUp.js 还有些不满足你的需求,那你可以选择自己来造轮子了。

造轮子篇

首先当然是阅读源码了

其实源码也就两部分核心代码

第一部分:主要是就是 requestAnimationFrame,在游览器不支持requestAnimationFrame 的情况下使用 setTimeout 来模拟,这段代码值得仔细阅读,自己在平时的项目中也能借鉴使用这段代码。

第二部分:就是 count 函数

看懂这两部分之后造轮子就相当的简单了, demo

造轮子过程中发现 countUp,并没有 autoplay 这个参数项可以让组件自动开始count,没关系。。。我们可以自己来撸,我们首先定义 autoplay 这个props为布尔值,默认所有组件 autoplay 为 true

props:{
  autoplay: {
   type: Boolean,
   required: false,
   default: true
  }
 }

定义好 props 之后只要在 mounted 生命周期内加一个判断就完事了。

mounted() {
 if (this.autoplay) {
  this.start();
 }
}

我们的 countUp 组件可以自动 count 了!

手把手带你封装一个vue component第三方库

上传 npm

在不跨项目的情况下之前所做的已经满足需求了。但我们不能就此满足,我想让世界上更多的人来使用我的插件,这时候就要上传npm了 demo 。

首先我们新建一个index.js

import CountTo from './vue-countTo.vue'

// 导出模块
export default CountTo

//global 情况下 自动安装
if (typeof window !== 'undefined' && window.Vue) {
 window.Vue.component('count-to', CountTo)
}

同时我们也要改造一下 webpack 的配置,因为不是所有使用你组件的人都是通过 npm 安装使用 import 引入组件的的。

还有很多人是通过 <script> 标签的方式直接引入的,所以我们要将 libraryTarget 改为 umd 格式

library: 'CountTo',
libraryTarget: 'umd',
umdNamedDefine: true

大功告成,现在只要将它发布到 npm 就可以了,首先注册一个npm 账号,

之后配置自己的 package.json (注意填写 version,每次发布的 version 不能相同;main 为入口文件地址)。

之后只要一行命令 npm publish 你的项目就发到 npm 了,快让小伙伴们一起来用你的vue component 吧!

手把手带你封装一个vue component第三方库

总结

这里这是拿了一个很简单的 countUp 组件举了一个简单例子,有的时候自己动手丰衣足食,很多插件的封装比想象中简单的多。产品经理再也不会看到我因为这个fu**插件怎么不支持这个功能而愁眉苦脸了,我们可以更好地满足产品了~~
完整项目地址:https://github.com/PanJiaChen/vue-countTo欢迎 star

完整项目地址:vue-element-admin

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持三水点靠木。

Javascript 相关文章推荐
获取css样式表内样式的js函数currentStyle(IE),defaultView(FF)
Feb 14 Javascript
读jQuery之十 事件模块概述
Jun 27 Javascript
关于onScroll事件在IE6下每次滚动触发三次bug说明
Sep 21 Javascript
javascript模拟订火车票和退票示例
Apr 24 Javascript
vue实现可增删查改的成绩单
Oct 27 Javascript
vue-loader教程介绍
Jun 14 Javascript
Angular.js初始化之ng-app的自动绑定与手动绑定详解
Jul 31 Javascript
vue单页应用加百度统计代码(亲测有效)
Jan 31 Javascript
AngularJS监听ng-repeat渲染完成的方法
Mar 20 Javascript
vue项目中使用百度地图的方法
Jun 08 Javascript
vue实现的下拉框功能示例
Jan 29 Javascript
JavaScript中Dom操作实例详解
Jul 08 Javascript
微信小程序实现简单表格
Feb 14 #Javascript
手挽手带你学React之React-router4.x的使用
Feb 14 #Javascript
详解JavaScript原生封装ajax请求和Jquery中的ajax请求
Feb 14 #jQuery
vue中各种通信传值方式总结
Feb 14 #Javascript
微信小程序实现banner图轮播效果
Jun 28 #Javascript
如何使用VuePress搭建一个类型element ui文档
Feb 14 #Javascript
JavaScript类型相关的常用操作总结
Feb 14 #Javascript
You might like
教你IIS6的PHP最佳配置方法
2006/09/05 PHP
用PHP生成自己的LOG文件
2006/10/09 PHP
用PHP实现递归循环每一个目录
2010/08/08 PHP
PHP中几种常见的超时处理全面总结
2012/09/11 PHP
PHP面向对象程序设计之接口用法
2014/08/20 PHP
客户端静态页面玩分页
2006/06/26 Javascript
一个基于jQuery的树型插件(OrangeTree)使用介绍
2012/05/03 Javascript
jQuery操作Select选择的Text和Value(获取/设置/添加/删除)
2013/03/06 Javascript
JS格式化数字金额用逗号隔开保留两位小数
2013/10/18 Javascript
jquery实现页面关键词高亮显示的方法
2015/03/12 Javascript
纯Javascript实现ping功能的方法
2015/03/20 Javascript
JavaScript访问字符串中单个字符的两种方法
2015/07/03 Javascript
基于bootstrap3和jquery的分页插件
2015/07/31 Javascript
详解js图片轮播效果实现原理
2015/12/17 Javascript
GitHub上一些实用的JavaScript的文件压缩解压缩库推荐
2016/03/13 Javascript
深入理解jQuery3.0的domManip函数
2016/09/01 Javascript
JavaScript对象创建模式实例汇总
2016/10/03 Javascript
bootstrap模态框实现拖拽效果
2016/12/14 Javascript
基于Bootstrap的Java开发问题汇总(Spring MVC)
2017/01/15 Javascript
javascript实现动态时钟的启动和停止
2020/07/29 Javascript
微信小程序关键字变色实现代码实例
2019/12/13 Javascript
原生js实现表格循环滚动
2020/11/24 Javascript
在Django的URLconf中使用多个视图前缀的方法
2015/07/18 Python
python方法生成txt标签文件的实例代码
2018/05/10 Python
selenium + python 获取table数据的示例讲解
2018/10/13 Python
如何在Django配置文件里配置session链接
2019/08/06 Python
css3 中的新特性加强记忆详解
2016/04/16 HTML / CSS
CSS3中引入多种自定义字体font-face
2020/06/12 HTML / CSS
英国皇室御用百货:福南梅森(Fortnum & Mason)
2017/12/03 全球购物
美国最受欢迎的度假目的地优惠套餐:BookVIP
2018/09/27 全球购物
电力公司个人求职信范文
2014/02/04 职场文书
酒店节能减排方案
2014/05/26 职场文书
电气工程及其自动化专业求职信
2014/06/23 职场文书
青年教师听课心得体会
2016/01/15 职场文书
python 破解加密zip文件的密码
2021/04/22 Python
超详细教你怎么升级Mysql的版本
2021/05/19 MySQL