前言
我们在项目中可能使用最多的就是提示组件,可偏偏用的最多的组件,你确定你真的了解他吗?我们今天就来探讨一下
~ 开始实现一下它
开始
实现一个组件其实并不难,创建一个组件,引入组件然后判断下显示隐藏
<template>
<div>
<Alert v-if="show">这是一条提示信息</Alert>
<button @click="show = true">显示</button>
</div>
</template>
<script>
import Alert from '../component/alert.vue';
export default {
components: { Alert },
data () {
return {
show: false
}
}
}
</script>
这样实现会有一下这些缺点
-
每个使用的地方,都需要注册
-
都需要将
<Alert>放置在模板中 -
需要额外的 data 来控制 Alert 的显示状态
-
Alert 的位置,是在当前组件位置,并非在 body 下,有可能会被其它组件遮挡
总之对于使用者很不友好,那怎样才能优雅地实现这样一个组件呢?
// 全局提示
window.alert('这是一条提示信息');
// 二次确认
const confirm = window.confirm('确认删除吗?');
if (confirm) {
// ok
} else {
// cancel
}
事实上,原生的 JavaScript 早已给出了答案:
所以我们需要尝试的从js调用组件的API
开始我们的第一步
我们期望最终的api是这样的
methods: {
handleShow () {
this.$Alert({
content: '这是一条提示信息',
duration: 3
})
}
}
把$Alert可以在任何位置调用,无需单独引入。该方法接收两个参数:
- content:提示内容
- duration:持续时间,单位秒,默认 1.5 秒,到时间自动消失。
我们从最佳的简单的入手,不考虑其他,先写一个基本的Alert组件。
在 src/component 下新建 alert 目录,并创建文件 alert.vue:
通知是多个的,我们用一个数组notices来管理每条通知
<!-- alert.vue -->
<template>
<div class="alert">
<div class="alert-main" v-for="item in notices" :key="item.name">
<div class="alert-content">{{ item.content }}</div>
</div>
</div>
</template>
<script>
export default {
data () {
return {
notices: []
}
}
}
</script>
Alert 组件不同于常规的组件使用方式,它最终是通过 JS 来调用的,因此组件不用预留 props 和 events 接口。
接下来,只要给数组 notices 增加数据,这个提示组件就能显示内容了,我们先假设,最终会通过 JS 调用 Alert 的一个方法 add,并将 content 和 duration 传入进来:
<!-- alert.vue,部分代码省略 -->
<script>
let seed = 0;
function getUuid() {
return 'alert_' + (seed++);
}
export default {
data () {
return {
notices: []
}
},
methods: {
add (notice) {
const name = getUuid();
let _notice = Object.assign({
name: name
}, notice);
this.notices.push(_notice);
// 定时移除,单位:秒
const duration = notice.duration;
setTimeout(() => {
this.remove(name);
}, duration * 1000);
},
remove (name) {
const notices = this.notices;
for (let i = 0; i < notices.length; i++) {
if (notices[i].name === name) {
this.notices.splice(i, 1);
break;
}
}
}
}
}
</script>
在 add 方法中,给每一条传进来的提示数据,加了一个不重复的 name 字段来标识,并通过 setTimeout 创建了一个计时器,当到达指定的 duration 持续时间后,调用 remove 方法,将对应 name 的那条提示信息找到,并从数组中移除。
由这个思路,Alert 组件就可以无限扩展,只要在 add 方法中传递更多的参数,就能支持更复杂的组件,比如是否显示手动关闭按钮、确定 / 取消按钮,甚至传入一个 Render 函数都可以。
实例化封装
这一步,我们对 Alert 组件进一步封装,让它能够实例化,而不是常规的组件使用方法。可以使用 Vue.extend 或 new Vue,然后用 $mount 挂载到 body 节点下。
在 src/components/alert 目录下新建 notification.js 文件:
// notification.js
import Alert from './alert.vue';
import Vue from 'vue';
Alert.newInstance = properties => {
const props = properties || {};
const Instance = new Vue({
data: props,
render (h) {
return h(Alert, {
props: props
});
}
});
const component = Instance.$mount();
document.body.appendChild(component.$el);
const alert = Instance.$children[0];
return {
add (noticeProps) {
alert.add(noticeProps);
},
remove (name) {
alert.remove(name);
}
}
};
export default Alert;
notification.js 并不是最终的文件,它只是对 alert.vue 添加了一个方法 newInstance。虽然 alert.vue 包含了 template、script、style 三个标签,并不是一个 JS 对象,那怎么能够给它扩展一个方法 newInstance 呢?事实上,alert.vue 会被 Webpack 的 vue-loader 编译,把 template 编译为 Render 函数,最终就会成为一个 JS 对象,自然可以对它进行扩展。
Alert 组件没有任何 props,这里在 Render Alert 组件时,还是给它加了 props,当然,这里的 props 是空对象 {},而且即使传了内容,也不起作用。这样做的目的还是为了扩展性,如果要在 Alert 上添加 props 来支持更多特性,是要在这里传入的。不过话说回来,因为能拿到 Alert 实例,用 data 或 props 都是可以的。
入口
最后要做的,就是调用 notification.js 创建实例,并通过 add 把数据传递过去,这是组件开发的最后一步,也是最终的入口。在 src/component/alert 下创建文件 alert.js:
// alert.js
import Notification from './notification.js';
let messageInstance;
function getMessageInstance () {
messageInstance = messageInstance || Notification.newInstance();
return messageInstance;
}
function notice({ duration = 1.5, content = '' }) {
let instance = getMessageInstance();
instance.add({
content: content,
duration: duration
});
}
export default {
info (options) {
return notice(options);
}
}
getMessageInstance 函数用来获取实例,它不会重复创建,如果 messageInstance 已经存在,就直接返回了,只在第一次调用 Notification 的 newInstance 时来创建实例。
alert.js 对外提供了一个方法 info,如果需要各种显示效果,比如成功的、失败的、警告的,可以在 info 下面提供更多的方法,比如 success、fail、warning 等,并传递不同参数让 Alert.vue 知道显示哪种状态的图标。本例因为只有一个 info,事实上也可以省略掉,直接导出一个默认的函数,这样在调用时,就不用 this.$Alert.info() 了,直接 this.$Alert()。
最后把 alert.js 作为插件注册到 Vue 里就行,在入口文件 src/main.js中,通过 prototype 给 Vue 添加一个实例方法:
结束
- Alert.vue 的最外层是有一个 .alert 节点的,它会在第一次调用
$Alert时,在 body 下创建,因为不在<router-view>内,它不受路由的影响,也就是说一经创建,除非刷新页面,这个节点是不会消失的,所以在 alert.vue 的设计中,并没有主动销毁这个组件,而是维护了一个子节点数组notices。 - .alert 节点是
position: fixed固定的,因此要合理设计它的z-index,否则可能被其它节点遮挡。 - notification.js 和 alert.vue 是可以复用的,如果还要开发其它同类的组件,比如二次确认组件
$Confirm, 只需要再写一个入口confirm.js,并将alert.vue进一步封装,将notices数组的循环体写为一个新的组件,通过配置来决定是渲染 Alert 还是 Confirm,这在可维护性上是友好的。 - 在 notification.js 的 new Vue 时,使用了 Render 函数来渲染 alert.vue,这是因为使用 template 在 runtime 的 Vue.js 版本下是会报错的。
结语
Vue.js 的精髓是组件,组件的精髓是 JavaScript。将 JavaScript 开发中的技巧结合 Vue.js 组件,就能玩出不一样的东西。