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

介绍

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

vue3.0自定义弹窗组件|vue3 pc端对话框vue3-layer_第1张图片

快速引入

// 在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.globalPropertiesapp.provide 详细使用可以去参看官网说明。
https://v3.cn.vuejs.org/api/a...
https://v3.cn.vuejs.org/guide...
另外使用的话,在这一篇文章也有些介绍。
https://segmentfault.com/a/11...

vue3.0自定义弹窗组件|vue3 pc端对话框vue3-layer_第2张图片

实现过程

在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上可通过createAppcreateVNode实现。大家感兴趣也可以看看之前分享的一篇文章。

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

image

你可能感兴趣的:(vue3,vue.js)