vue3.0自定义弹窗组件|vue3 pc端对话框vue3-layer

介绍

Vue3-Layer 一款基于vue3.x实现的PC桌面端弹窗组件。拥有极简的调用方式、超多的参数配置。支持拖拽、缩放、最大化、全局、自定义弹窗样式等功能。

快速引入

// 在main.js中全局引入组件
import { createApp } from 'vue'
import App from './App.vue'

const app = createApp(App)

// 引入Element-Plus组件库
import ElementPlus from 'element-plus'
import 'element-plus/lib/theme-chalk/index.css'

// 引入弹窗组件v3layer
import Vue3Layer from './components/v3layer'

app.use(ElementPlus)
app.use(Vue3Layer)

app.mount('#app')

v3layer同样支持标签式+函数式两种调用方式。

• 标签式调用

• 函数式调用

let $el = v3layer({
    title: '标题内容',
    content: '
这里是内容信息！
', 
    shadeClose: false,
    zIndex: 1011,
    lockScroll: false,
    xclose: true,
    resize: true,
    dragOut: true,
    btns: [
        {text: '取消', click: () => { $el.close() }},
        {text: '确认', click: () => handleSure},
    ]
});

当弹窗类型为 message | popover | notify 则调用如下：

v3layer.message({...})
v3layer.notify({...})
v3layer.popover({...})

传入自定义参数即可实现上述弹窗类型效果。

Vue3.0中提供了两种全局挂载方式 app.config.globalProperties 和 app.provide 详细使用可以去参看官网说明。
https://v3.cn.vuejs.org/api/a...
https://v3.cn.vuejs.org/guide...
另外使用的话，在这一篇文章也有些介绍。
https://segmentfault.com/a/11...

实现过程

在components目录下新建v3layer文件。

• v3layer配置参数

|props参数|
v-model         是否显示弹框
id              弹窗唯一标识
title           标题
content         内容（支持String、带标签内容、自定义插槽内容）***如果content内容比较复杂，推荐使用标签式写法
type            弹框类型（toast|footer|actionsheet|actionsheetPicker|android|ios|contextmenu|drawer|iframe）
layerStyle      自定义弹窗样式
icon            toast图标（loading | success | fail）
shade           是否显示遮罩层
shadeClose      是否点击遮罩时关闭弹窗
lockScroll      是否弹窗出现时将body滚动锁定
opacity         遮罩层透明度
xclose          是否显示关闭图标
xposition       关闭图标位置（left | right | top | bottom）
xcolor          关闭图标颜色
anim            弹窗动画（scaleIn | fadeIn | footer | fadeInUp | fadeInDown | fadeInLeft | fadeInRight）
position        弹出位置（auto | ['100px','50px'] | t | r | b | l | lt | rt | lb | rb）
drawer          抽屉弹窗（top | right | bottom | left）
follow          跟随元素定位弹窗（支持元素.kk #kk 或 [e.clientX, e.clientY]）
time            弹窗自动关闭秒数（1、2、3）
zIndex          弹窗层叠（默认8080）
teleport        指定挂载节点（默认是挂载组件标签位置，可通过teleport自定义挂载位置） teleport="body | #xxx | .xxx"
topmost         置顶当前窗口（默认false）
area            弹窗宽高（默认auto）设置宽度area: '300px' 设置高度area:['', '200px'] 设置宽高area:['350px', '150px']
maxWidth        弹窗最大宽度（只有当area:'auto'时，maxWidth的设定才有效）
maximize        是否显示最大化按钮（默认false）
fullscreen      全屏弹窗（默认false）
fixed           弹窗是否固定
drag            拖拽元素（可定义选择器drag:'.xxx' | 禁止拖拽drag:false）
dragOut         是否允许拖拽到窗口外（默认false）
lockAxis        限制拖拽方向可选: v 垂直、h 水平，默认不限制
resize          是否允许拉伸尺寸（默认false）
btns            弹窗按钮（参数：text|style|disabled|click）
++++++++++++++++++++++++++++++++++++++++++++++
|emit事件触发|
success         层弹出后回调（@success="xxx"）
end             层销毁后回调（@end="xxx"）
++++++++++++++++++++++++++++++++++++++++++++++
|event事件|
onSuccess       层打开回调事件
onEnd           层关闭回调事件

• v3layer模板及逻辑处理

/**
 * @Desc     Vue3.0桌面端弹窗组件V3Layer
 * @Time     andy by 2021-1
 * @About    Q：282310962  wx：xy190310
 */

大家可以在此基础上扩充一些想要的效果。
vue3.0中把弹框实例挂载到body上可通过createApp或createVNode实现。大家感兴趣也可以看看之前分享的一篇文章。

ok，使用Vue3开发自定义alert/dialog组件就分享到这里。感谢大家的阅读！✍