手把手教你在 Vue3 中自定义插件

开发
最近在录 TienChin 项目,项目涉及到了 Vue 中插件的定义,因此整了这么一篇文章,手把手教大家在 Vue3 中定义插件,这个技能掌握了,就可以看懂 TienChin 前端代码了。

最近在录 TienChin 项目,项目涉及到了 Vue 中插件的定义,因此整了这么一篇文章,手把手教大家在 Vue3 中定义插件,这个技能掌握了,就可以看懂 TienChin 前端代码了。

1. Vue 插件

在 Vue 中,一些简单的功能,我们可以直接定义为全局方法,然后挂到 Vue 上就能使用了,例如在 vhr 中,我们将网络请求方法进行封装,然后挂到了 Vue.prototype 上就可以了,类似下面这样:

import {postRequest} from "./utils/api";

Vue.prototype.postRequest = postRequest;

然后在使用的地方,就可以通过 this.postRequest 去使用了。

小伙伴们需要注意,这个在 Vue3 中有所变化,prototype 变为了 config.globalProperties,也就是在 Vue3 中再想要挂载全局方法,应该是 const app = createApp(App);app.config.globalProperties.useDict = useDict 这种形式了(具体我将在 TienChin 项目中和大家细聊)。

这也算是一种插件定义方式,但是这种一般适用于一些工具方法,无法定义一些比较复杂的插件,复杂的插件还是得通过 Vue 中提供的插件定义方式来定义。

2. 自定义插件

2.1 基本用法

首先我们新建一个目录 plugins 专门用来放我们的插件,然后在这个目录中新建一个 index.js 文件用来开发插件,内容如下:

export default {
install: (app, options) => {
console.log("我的第一个插件")
}
};

install 中的方法将会被自动执行。

接下来我们就可以在 main.js 中引入我们这个插件了:

const app = createApp(App);

import plugin from './plugins'

app.use(plugin);

app.use 就表示引入插件,引入插件之后,插件中的 install 方法就会被自动执行。

app.use 方法接收两个参数,第一个参数就是我们导入的插件 js 对象,第二个参数是可选的,大家看到插件定义时候的 install 方法有两个参数,第一个参数是 Vue 实例,这是自动传入的,第二个参数 options 则是我们在 app.use 中,通过第二个参数传入进来的。当然上面这个例子中松哥没有传递第二个参数。

好了,如此配置之后,接下来启动项目,控制台就可以看到有日志打出了。

图片

这样的插件未免过于简单,接下来我们就给这个插件加点料。

2.2 加入组件

首先我们定义一个新的组件,如下:

<template>
<div>
<h1><a href="http://www.javaboy.org">javaboy</a></h1>
</div>
</template>

<script>
export default {
name: "MyBanner"
}
</script>

然后我们现在就可以在插件中将这个组件注册为一个全局组件了,如下:

import MyBanner from "@/plugins/components/MyBanner";

export default {
install: (app, options) => {
console.log("我的第一个插件")
app.component('my-banner', MyBanner);
}
};

首先在插件中导入这个组件,然后通过 app 进行组件注册,注册完成后,我们就可以在项目任意位置使用 my-banner 组件了,如下:

<template>
<div>
<my-banner></my-banner>
</div>
</template>

最终显示效果如下:

图片图片

2.3 加入指令

我们甚至还可以在插件中注册一个指令,如下:

import MyBanner from "@/plugins/components/MyBanner";

export default {
install: (app, options) => {
console.log("我的第一个插件")
app.component('my-banner', MyBanner);
app.directive("font-size", (el, binding, vnode) => {
var size = 16;
switch (binding.arg) {
case "small":
size = 16;
break;
case "large":
size = 32;
break;
default:
size = 48;
break;
}
el.style.fontSize = size + "px";
});
}
};

现在,我们就可以在项目中随时随地去使用这个指令了,例如在我们刚刚自定义的 my-banner 中使用这个指令:

<template>
<div>
<h1><a href="http://www.javaboy.org" v-font-size:small>javaboy</a></h1>
</div>
</template>

<script>
export default {
name: "MyBanner"
}
</script>

我们甚至可以通过 options 将指令中字体的大小动态的传进来,如下:

import MyBanner from "@/plugins/components/MyBanner";

export default {
install: (app, options) => {
console.log("我的第一个插件")
app.component('my-banner', MyBanner);
app.directive("font-size", (el, binding, vnode) => {
var size = 16;
switch (binding.arg) {
case "small":
size = options.small;
break;
case "large":
size = options.large;
break;
default:
size = options.defaut;
break;
}
el.style.fontSize = size + "px";
});
}
};

options 是插件注册时候传入的一个 JSON 参数,small、large 以及 default 分别对应的字体多大,要看插件注册时传入的值:

const app = createApp(App);

import plugin from './plugins'

app.use(plugin, {small: 16, large: 32, default: 48});

第二个参数,大家看,就是 options 参数的值。

现在大家想想我们平时用 ElementUI 的时候,Vue.use 方法,传入 ElementUI,再传入一些其他参数,看了上面这个例子,ElementUI 引入到底是怎么个引入法现在大家就明白了吧。

2.4 provide & inject

在插件中,也可以通过 provide 来提供一个方法,在需要使用该方法的地方,通过 inject 注入方法,然后就可以使用了,如下:

import MyBanner from "@/plugins/components/MyBanner";

export default {
install: (app, options) => {
console.log("我的第一个插件")
app.component('my-banner', MyBanner);
app.directive("font-size", (el, binding, vnode) => {
var size = 16;
switch (binding.arg) {
case "small":
size = options.small;
break;
case "large":
size = options.large;
break;
default:
size = options.defaut;
break;
}
el.style.fontSize = size + "px";
});
const clickMe = () => {
console.log("==========clickMe=========")
}
app.provide('clickMe', clickMe);
}
};

在需要使用的地方,通过 inject 注入方法后就可以使用了,如下:

<template>
<div>
<h1><a href="http://www.javaboy.org" v-font-size:small>javaboy</a></h1>
</div>
</template>

<script>

import {inject} from "vue";

export default {
name: "MyBanner",
mounted() {
const clickMe = inject('clickMe');
clickMe();
}
}
</script>

3. 小结

整体上来说,通过这种方式来自定义插件,能够实现的内容比较丰富。如果只是想挂一个全局方法来用,那么其实是没有必要定义插件的。如果只是想挂载一个全局方法,在 Vue2 中可以按照如下方式使用:

Vue.prototype.postRequest = postRequest;

在 Vue3 中则可以通过如下方式:

app.config.globalProperties.useDict = useDict
责任编辑:赵宁宁 来源: 江南一点雨
相关推荐

2022-07-26 01:06:18

Vue3自定义指令

2022-05-11 10:45:21

SpringMVC框架Map

2021-02-26 11:54:38

MyBatis 插件接口

2022-03-24 15:28:43

Vue开发框架

2021-11-30 08:19:43

Vue3 插件Vue应用

2023-07-30 15:11:03

Vue3第三方组件库

2011-04-28 15:09:15

jQueryjqPlot

2024-03-05 18:27:43

2023-05-29 09:37:17

Vue3Vite

2009-06-02 15:38:36

eclipse streclipse开发steclipse str

2011-03-28 16:14:38

jQuery

2024-03-18 18:07:38

VSCode插件文件

2020-06-01 16:25:43

WindowsLinux命令

2011-05-03 15:59:00

黑盒打印机

2011-01-10 14:41:26

2023-06-28 08:05:46

场景vue3自定义

2021-07-14 09:00:00

JavaFX开发应用

2011-02-22 13:46:27

微软SQL.NET

2021-12-28 08:38:26

Linux 中断唤醒系统Linux 系统

2020-11-03 14:10:29

Vue服务端渲染前端
点赞
收藏

51CTO技术栈公众号