Vue插件开发与实战

本文首发于掘金专栏,发布于我的独立博客简书,转载请保留原文链接。

通常在开发一个项目的时候,会用到类似弹出框、提示框这样的全局组件,我们可以把它们封装起来,以插件的形式进行调用。

插件vs组件

插件可以封装组件,组件可以暴露数据给插件。

一个Vue插件可以是一堆Vue组件的集合,也可以在Vue的原型上进行扩展,如 Vuex、Vue-Router。

如果一个组件需要在多个页面频繁使用,最好的方式就是封装成插件。

插件的分类

  1. 添加全局方法或者属性,如: vue-custom-element
  2. 添加全局资源:指令/过滤器/过渡等,如 vue-touch
  3. 通过全局 mixin 方法添加一些组件选项,如 vuex
  4. 添加 Vue 实例方法,通过把它们添加到 Vue.prototype 上实现。
  5. 一个库,提供自己的 API,同时提供上面提到的一个或多个功能,如 vue-router

下面要讲的toast插件就是通过添加实例方法实现的。

开发

Vue.js 的插件应当有一个公开方法 install() ,可以理解为向全局注册插件,第一个参数是 Vue 构造器,第二个参数则是插件的配置对象(可选)。

plugin.install = function (Vue, options) {
  // 1. 添加全局方法或属性
  Vue.myGlobalMethod = function () {...}
  // 2. 添加全局资源
  Vue.directive('my-directive', {...})
  // 3. 通过全局mixin方法添加一些组件选项
  Vue.mixin({...})
  // 4. 添加实例方法
  Vue.prototype.$myMethod = function () {...}
}

使用

通过全局方法 Vue.use() 使用插件:

import Plugin from './components/common/plugin'
Vue.use(Plugin)

具体使用方法请参考官方文档,接下来我们从零开始编写一个Vue的插件。

toast是一种轻量的提示,在页面中间显示,并且会在2秒(默认值,可修改)之后自动消失。

步骤:

  1. 编写组件
  2. 注册插件、添加实例方法
  3. 安装插件

目录结构

.
├── build
├── src
│   ├── components
│   │   ├── toast
│   │   │   ├── toast.vue #toast组件
│   │   │   ├── index.js #插件逻辑
│   ├── App.vue
│   ├── main.js
├── index.html
├── package.json

创建 toast.vue 文件,用于编写toast组件

<template>
  <transition name="fade">
    <div class="toast" v-show="show">{{ message }}</div>
  </transition>
</template>

<script>
  export default {
    data () {
      return {
        show: false,
        message: ''
      }
    }
  }
</script>

<style lang="scss" scoped>
.toast {
  position: fixed;
  top: 40%;
  left: 50%;
  margin-left: -15vw;
  padding: 2vw;
  width: 30vw;
  font-size: 4vw;
  color: #fff;
  text-align: center;
  background-color: rgba(0, 0, 0, 0.8);
  border-radius: 5vw;
  z-index: 999;
}

.fade-enter-active, .fade-leave-active{
  transition: 0.3s ease-out;
}
.fade-enter {
  opacity: 0;
  transform: scale(1.2);
}
.fade-leave-active {
  opacity: 0;
  transform: scale(0.8);
}
</style>

toast组件需要的 message 数据需要在插件调用时传入,接下来在 index.js 中完成插件的注册和业务逻辑

import ToastComponent from './toast'

const Toast = {}

/**
 * @method 注册插件
 * @param {Function} Vue构造器
 */
Toast.install = (Vue) => {
  const ToastConstructor = Vue.extend(ToastComponent)
  const instance = new ToastConstructor() // 创建toast子实例
  instance.$mount(document.createElement('div')) // 挂载实例到我们创建的DOM上
  document.body.appendChild(instance.$el)

  /**
   * @method 提示框
   * @param {String} msg 内容
   * @param {Number} duration 显示时间, 默认2000
   */
  // 添加实例方法,以供全局调用
  Vue.prototype.$toast = (msg, duration = 2000) => {
    instance.message = msg
    instance.show = true // 调用$toast()则显示提示
    setTimeout(() => {
      instance.show = false // duration秒后toast隐藏
    }, duration)
  }
}

export default Toast

index.js 首先使用 install() 注册了toast插件,然后通过Vue构造器创建了子实例,使用$mount() 将实例挂载到了我们创建的DOM上,最后一步则是添加实例方法。这样等在 main.js 安装了插件后,就可以到 App.vuethis.$toast(...) 全局调用toast了。

下一步就是去入口文件 main.js 里引入插件了

import Vue from 'vue'
import App from './App.vue'
// 引入插件
import Toast from './components/toast'
// 使用插件
Vue.use(Toast)

new Vue({
  el: '#app',
  render: h => h(App)
})

最后在组件中全局调用 $toast() 即可

<template>
  <div id="app">
    <button @click="toast">Toast</button>
  </div>
</template>

<script>
export default {
  name: 'app',
  data () {
    return {}
  },
  methods: {
    toast () {
      // 全局调用toast
      this.$toast('Hello Vue Plugin', 1500)
    }
  }
}
</script>

<style lang="scss">
</style>

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 217,542评论 6 504
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,822评论 3 394
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 163,912评论 0 354
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,449评论 1 293
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,500评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,370评论 1 302
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,193评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,074评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,505评论 1 314
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,722评论 3 335
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,841评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,569评论 5 345
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,168评论 3 328
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,783评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,918评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,962评论 2 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,781评论 2 354

推荐阅读更多精彩内容

  • 转载 :OpenDiggawesome-github-vue 是由OpenDigg整理并维护的Vue相关开源项目库...
    果汁密码阅读 23,125评论 8 124
  • 雾失楼台,月迷津渡。桃源望断无寻处。可堪孤馆闭春寒,杜鹃声里斜阳暮。 驿寄梅花,鱼传尺素。砌成此恨无重数。郴江幸自...
    艺圃阅读 144评论 0 0
  • 岁月飞梦雁南归, 轻舟东去又复回。 玉笛声声渐行远, 芦花纷纷又枯萎。 (清风明月于十一月二十九号)
    清风明月冯耀杰阅读 190评论 0 7
  • 第一章 新生报到 我曾经听别人说过,我们的大学时光是最美好的…… 2017年,...
    佳心思言阅读 209评论 0 0