Vue插件的开发(一)
2017.08.25
hzzly
前言:随着 Vue.js 越来越火,Vue.js 的相关插件也在不断的被贡献出来,数不胜数。比如官方推荐的 vue-router、vuex 等,都是非常优秀的插件。但是我们更多的人还只停留在使用的阶段,比较少自己开发。所以接下来通过一个简单的 vue-toast 插件,来了解掌握插件的开发和使用。
认识插件
想要开发插件,先要认识一个插件是什么样子的。官方文档:插件
Vue.js 的插件应当有一个公开方法 install 。这个方法的第一个参数是 Vue 构造器 , 第二个参数是一个可选的选项对象:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20
| MyPlugin.install = function (Vue, options) { Vue.myGlobalMethod = function () { } Vue.directive('my-directive', { bind (el, binding, vnode, oldVnode) { } ... }) Vue.mixin({ created: function () { } ... }) Vue.prototype.$myMethod = function (options) { } }
|
接下来要讲到的 vue-toast 插件则是通过添加实例方法实现的。我们先来看个小例子。先新建个js文件来编写插件:toast.js
1 2 3 4 5 6
| var Toast = {}; Toast.install = function (Vue, options) { Vue.prototype.$msg = 'Hello World'; } module.exports = Toast;
|
在 main.js 中,需要导入 toast.js 并且通过全局方法 Vue.use() 来使用插件:
1 2 3 4
| import Vue from 'vue'; import Toast from './toast.js'; Vue.use(Toast);
|
然后,我们在组件中来获取该插件定义的 $msg 属性。
1 2 3 4 5 6
| export default { mounted(){ console.log(this.$msg); } }
|
可以看到,控制台成功的打印出了 Hello World 。既然 $msg 能获取到,那么我们就可以来实现我们的 vue-toast 插件了。
开发 vue-toast 插件
需求:在组件中通过调用 **this.$toast(‘网络请求失败’) **来弹出提示,默认在底部显示。可以通过调用 this.$toast.top() 或 this.$toast.center() 等方法来实现在不同位置显示。
整理一下思路,弹出提示的时候,我可以在 body 中添加一个 div 用来显示提示信息,不同的位置我通过添加不同的类名来定位,那就可以开始写了。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
| var Toast = {}; Toast.install = function (Vue, options) { Vue.prototype.$toast = (tips) => { let toastTpl = Vue.extend({ template: '<div class="vue-toast">' + tips + '</div>' }); let tpl = new toastTpl().$mount().$el; document.body.appendChild(tpl); setTimeout(function () { document.body.removeChild(tpl); }, 2500) } } module.exports = Toast;
|
好像很简单,我们就实现了 this.$toast() ,接下来显示不同位置
1 2 3 4 5 6
| ['bottom', 'center', 'top'].forEach(type => { Vue.prototype.$toast[type] = (tips) => { return Vue.prototype.$toast(tips,type) } })
|
这里把 type 传给 $toast 在该方法里进行不同位置的处理,上面说了通过添加不同的类名(toast-bottom、toast-top、toast-center)来实现,那 $toast 方法需要小小修改一下
1 2 3 4 5 6
| Vue.prototype.$toast = (tips,type) => { let toastTpl = Vue.extend({ template: '<div class="vue-toast toast-'+ type +'">' + tips + '</div>' }); ... }
|
好像差不多了。但是如果我想默认在顶部显示,我每次都要调用 this.$toast.top() 好像就有点多余了,我能不能 this.$toast() 就直接在我想要的地方呢?还有我不想要 2.5s 后才消失呢?这时候注意到 Toast.install(Vue,options) 里的 options 参数,我们可以在 Vue.use() 通过 options 传进我们想要的参数。最后修改插件如下:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33
| var Toast = {}; Toast.install = function (Vue, options) { let opt = { defaultType:'bottom', duration:'2500' } for(let property in options){ opt[property] = options[property]; } Vue.prototype.$toast = (tips,type) => { if(type){ opt.defaultType = type; } if(document.getElementsByClassName('vue-toast').length){ return; } let toastTpl = Vue.extend({ template: '<div class="vue-toast toast-'+opt.defaultType+'">' + tips + '</div>' }); let tpl = new toastTpl().$mount().$el; document.body.appendChild(tpl); setTimeout(function () { document.body.removeChild(tpl); }, opt.duration) } ['bottom', 'center', 'top'].forEach(type => { Vue.prototype.$toast[type] = (tips) => { return Vue.prototype.$toast(tips,type) } }) } module.exports = Toast;
|
这样子一个简单的 vue 插件就实现了,并且可以通过 npm 打包发布,下次就可以使用 npm install 来安装了。
好久没更新博客,逃。。。