Skip to content

Latest commit

 

History

History
131 lines (100 loc) · 4.1 KB

第15章 插件.md

File metadata and controls

131 lines (100 loc) · 4.1 KB

概述

插件 (Plugins) 是一种能为 Vue 添加全局功能的工具代码。下面是如何安装一个插件的示例:

import { createApp } from 'vue'

const app = createApp({})

app.use(myPlugin, {
  /* 可选的选项 */
})

一个插件可以是一个拥有 install() 方法的对象,也可以直接是一个安装函数本身。安装函数会接收到安装它的应用实例和传递给 app.use() 的额外选项作为参数:

const myPlugin = {
  install(app, options) {
    // 配置此应用
  }
}

插件没有严格定义的使用范围,但是插件发挥作用的常见场景主要包括以下几种:

  1. 第三方库集成:你可以将第三方库封装成插件,以便在 Vue 3 项目中进行集成和使用。例如,集成数据可视化库、UI 组件库、地图库等。
  2. 自定义指令:通过插件可以方便地注册和使用自定义指令。自定义指令用于在 DOM 元素上添加特定的行为或交互效果。例如,实现拖拽、无限滚动、复制粘贴等功能。
  3. 全局方法和属性:通过插件可以将全局方法和属性添加到 Vue 实例中,以便在整个应用程序中使用。例如,添加全局的工具函数、常量、API 封装等。
  4. 增强实例功能:插件可以扩展 Vue 实例的功能,例如添加实例方法、混入(mixin)、拦截生命周期钩子等。这样可以在多个组件中共享相同的功能和逻辑。
  5. 路由拦截和导航守卫:通过插件可以实现路由的拦截和导航守卫,用于控制页面跳转、权限验证、页面切换动画等。
  6. 状态管理集成:如果你使用 Vuex 或其他状态管理库,可以将其封装成插件,方便在 Vue 3 项目中集成和管理应用的状态。
  7. 第三方服务集成:如果你需要集成第三方服务,例如社交登录、地图服务、推送通知等,可以将其封装成插件,以便在 Vue 3 项目中使用。

总之,插件在 Vue 3 中提供了一种扩展和集成功能的机制,可以帮助你将通用的功能、库或服务集成到 Vue 3 项目中,提供更好的开发体验和代码复用性。插件的应用场景取决于具体的需求,可以根据项目的需求进行定制和开发。

插件示例

1. i18n

定义插件:

// plugins/i18n.js
import type { App } from 'vue';

export default {
  install: (app: App, options: Record<string, any>) => {
    // 注入一个全局可用的 $translate() 方法
    app.config.globalProperties.$translate = (key: string) => {
      // 获取options对象的深层属性
      // 使用key作为索引
      return key.split('.').reduce((o: any, k: string) => {
        if (o) {
          return o[k] as string;
        }
        return '';
      }, options);
    };
  },
};

增加ts语法提示

// typings/index.d.ts
export {};
declare module 'vue' {
  interface ComponentCustomProperties {
    $translate: (key: string) => string;
  }
}

引入插件:

import i18nPlugin from './plugins/i18n'

app.use(i18nPlugin, {
  greetings: {
    hello: 'Bonjour!'
  }
}

使用插件:

<p>{{ $translate('greetings.hello') }}</p>

插件中的 Provide / Inject

在插件中,我们可以通过 provide 来为插件用户供给一些内容。举例来说,我们可以将插件接收到的 options 参数提供给整个应用,让任何组件都能使用这个翻译字典对象。

import type { App } from 'vue';

export default {
  install: (app: App, options: Record<string, any>) => {
    app.config.globalProperties.$translate = (key: string) => {
      return key.split('.').reduce((o: any, k: string) => {
        if (o) {
          return o[k] as string;
        }
        return '';
      }, options);
    };
    // +++++++
    app.provide('i18n', options);
    // +++++++
  },
};

现在,插件用户就可以在他们的组件中以 i18n 为 key 注入并访问插件的选项对象了。

<script setup>
import { inject } from 'vue'

const i18n = inject('i18n')

console.log(i18n.greetings.hello)
</script>

2. 注入自定义指令