今天分享的是Vue3系列的自定义桌面对话框组件v3layer。

V3Layer基于vue3.0的多功能PC网页弹出组件，拥有超过10+的弹出窗口类型和30+的参数配置，支持拖动(自定义拖动区域)、缩放、最大化、全屏、自定义置顶叠加等功能。

快速介绍

在***in.js中引入v3layer组件

import { createApp } from 'vue'import App from './App.vue'// 引入Element-Plus组件库import ElementPlus from 'element-plus'import 'element-plus/lib/theme-chalk/index.css'// 引入弹窗组件v3layerimport V3Layer from './components/v3layer'createApp(App).use(ElementPlus).use(V3Layer).mount('#app')

V3layer支持组件+函数调用方法。

组件式

<v3-layer v-model="showDialog" title="标题内容" content="<div style='color:#f57b16;padding:30px;'>这里是内容信息！</div>" z-index="2021" lockScroll="false" xclose resize dragOut :btns="[ {text: '取消', click: () => showDialog=false}, {text: '确认', style: 'color:#f90;', click: handleSure}, ]"/> <template v-slot:content>这里是自定义插槽内容信息！</template></v3-layer>

函数式

let $el = v3layer({ title: '标题内容', content: '<div style='color:#f57b16;padding:30px;'>这里是内容信息！</div>', shadeClose: false, zIndex: 2021, lockScroll: false, xclose: true, resize: true, dragOut: true, btns: [ {text: '取消', click: () => { $el.close() }}, {text: '确认', click: () => handleSure}, ]});

当弹出窗口类型为消息|通知|弹出时，调用方法如下:

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

Vue3.0提供
app . config . global properties或app.provide来挂载全局函数。

如果是 app.config.globalProperties 方式创建：// vue2中调用methods: { showDialog() { this.$v3layer({...}) }}// vue3中调用setup() { // 获取上下文 const { ctx } = getCurrentInstance() ctx.$v3layer({...})}如果是 app.provide 方式创建：// vue2中调用methods: { showDialog() { this.v3layer({...}) }}// vue3中调用setup() { const v3layer = inject('v3layer') const showDialog = () => { v3layer({...}) } return { v3layer, showDialog }}

参数配置参数配置

V3layer支持灵活配置以下30+参数，实现各种弹出场景。

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']***xWidth 弹窗最大宽度（只有当area:'auto'时，***xWidth的设定才有效）***ximize 是否显示最大化按钮（默认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 层关闭回调事件

v3层弹出模板

<template> <div ref="elRef" v-show="opened" class="vui__layer" :class="{'vui__layer-closed': closeCls}" :id="id"> <!-- //蒙版 --> <div v-if="JSON.parse(shade)" class="vlayer__overlay" @click="shadeClicked" :style="{opacity}"></div> <div class="vlayer__wrap" :class="['anim-'+anim, type&&'popui__'+type, tipArrow]" :style="[layerStyle]"> <div v-if="title" class="vlayer__wrap-tit" v-html="title"></div> <div v-if="type=='toast'&&icon" class="vlayer__toast-icon" :class="['vlayer__toast-'+icon]" v-html="toastIcon[icon]"></div> <div class="vlayer__wrap-cntbox"> <!-- 判断插槽是否存在 --> <template v-if="$slots.content"> <div class="vlayer__wrap-cnt"><slot name="content" /></div> </template> <template v-else> <template v-if="content"> <iframe v-if="type=='iframe'" scrolling="auto" allowtransparency="true" frameborder="0" :src="content"></iframe> <!-- message|notify|popover --> <div v-else-if="type=='message' || type=='notify' || type=='popover'" class="vlayer__wrap-cnt"> <i v-if="icon" class="vlayer-msg__icon" :class="icon" v-html="messageIcon[icon]"></i> <div class="vlayer-msg__group"><div v-if="title" class="vlayer-msg__title" v-html="title"></div><div v-html="content"></div></div> </div> <div v-else class="vlayer__wrap-cnt" v-html="content"></div> </template> </template> <slot /> </div> <div v-if="btns" class="vlayer__wrap-btns"> <span v-for="(btn,index) in btns" :key="index" class="btn" :style="btn.style" @click="btnClicked($event,index)" v-html="btn.text"></span> </div> <span v-if="xclose" class="vlayer__xclose" :class="!***ximize&&xposition" :style="{'color': xcolor}" @click="close"></span> <span v-if="***ximize" class="vlayer__***ximize" @click="***ximizeClicked($event)"></span> <span v-if="resize" class="vlayer__resize"></span> </div> <!-- 优化拖拽卡顿 --> <div class="vlayer__dragfix"></div> </div></template><script> import { onMounted, onUnmounted, ref, reactive, watch, toRefs, nextTick } from 'vue' import domUtils from './utils/dom.js' // 索引，蒙层控制，定时器 let $index = 0, $locknum = 0, $timer = {}, $closeTimer = null export default { props: { // ... }, emits: [ 'update:modelValue' ], setup(props, context) { const elRef = ref(null); const data = reactive({ opened: false, closeCls: '', toastIcon: { // ... }, messageIcon: { // ... }, vlayerOpts: {}, tipArrow: null, }) onMounted(() => { if(props.modelValue) { open(); } window.addEventListener('resize', autopos, false); }) onUnmounted(() => { window.removeEventListener('resize', autopos, false); clearTimeout($closeTimer); }) // **弹层v-model watch(() => props.modelValue, (val) => { // console.log('V3Layer is now [%s]', val ? 'show' : 'hide') if(val) { open(); }else { close(); } }) // 打开弹窗 const open = () => { if(data.opened) return; data.opened = true; typeof props.onSuccess === 'function' && props.onSuccess(); const dom = elRef.value; // 弹层挂载位置 if(props.teleport) { nextTick(() => { let teleportNode = document.querySelector(props.teleport); teleportNode.appendChild(dom); auto(); }) } callback(); } // 关闭弹窗 const close = () => { if(!data.opened) return; let dom = elRef.value; let vlayero = dom.querySelector('.vlayer__wrap'); let ocnt = dom.querySelector('.vlayer__wrap-cntbox'); let o***x = dom.querySelector('.vlayer__***ximize'); data.closeCls = true; clearTimeout($closeTimer); $closeTimer = setTimeout(() => { data.opened = false; data.closeCls = false; if(data.vlayerOpts.lockScroll) { $locknum--; if(!$locknum) { document.body.style.paddingRight = ''; document.body.classList.remove('vui__body-hidden'); } } if(props.time) { $index--; } // 清除弹窗样式 vlayero.style.width = vlayero.style.height = vlayero.style.top = vlayero.style.left = ''; ocnt.style.height = ''; o***x && o***x.classList.contains('***ximized') && o***x.classList.remove('***ximized'); data.vlayerOpts.isBodyOverflow && (document.body.style.overflow = ''); context.emit('update:modelValue', false); typeof props.onEnd === 'function' && props.onEnd(); }, 200) } // 弹窗位置 const auto = () => { // ... autopos(); // 全屏弹窗 if(props.fullscreen) { full(); } // 弹窗拖动|缩放 move(); } const autopos = () => { if(!data.opened) return; let oL, oT let pos = props.position; let isFixed = JSON.parse(props.fixed); let dom = elRef.value; let vlayero = dom.querySelector('.vlayer__wrap'); if(!isFixed || props.follow) { vlayero.style.position = 'absolute'; } let area = [domUtils.client('width'), domUtils.client('height'), vlayero.offsetWidth, vlayero.offsetHeight] oL = (area[0] - area[2]) / 2; oT = (area[1] - area[3]) / 2; if(props.follow) { offset(); }else { typeof pos === 'object' ? ( oL = parseFloat(pos[0]) || 0, oT = parseFloat(pos[1]) || 0 ) : ( pos == 't' ? oT = 0 : pos == 'r' ? oL = area[0] - area[2] : pos == 'b' ? oT = area[1] - area[3] : pos == 'l' ? oL = 0 : pos == 'lt' ? (oL = 0, oT = 0) : pos == 'rt' ? (oL = area[0] - area[2], oT = 0) : pos == 'lb' ? (oL = 0, oT = area[1] - area[3]) : pos == 'rb' ? (oL = area[0] - area[2], oT = area[1] - area[3]) : null ) vlayero.style.left = parseFloat(isFixed ? oL : domUtils.scroll('left') + oL) + 'px'; vlayero.style.top = parseFloat(isFixed ? oT : domUtils.scroll('top') + oT) + 'px'; } } // 元素跟随定位 const offset = () => { let oW, oH, pS let dom = elRef.value let vlayero = dom.querySelector('.vlayer__wrap'); oW = vlayero.offsetWidth; oH = vlayero.offsetHeight; pS = domUtils.getFollowRect(props.follow, oW, oH); data.tipArrow = pS[2]; vlayero.style.left = pS[0] + 'px'; vlayero.style.top = pS[1] + 'px'; } // 最大化弹窗 const full = () => { // ... } // 恢复弹窗 const restore = () => { let dom = elRef.value; let vlayero = dom.querySelector('.vlayer__wrap'); let otit = dom.querySelector('.vlayer__wrap-tit'); let ocnt = dom.querySelector('.vlayer__wrap-cntbox'); let obtn = dom.querySelector('.vlayer__wrap-btns'); let o***x = dom.querySelector('.vlayer__***ximize'); let t = otit ? otit.offsetHeight : 0 let b = obtn ? obtn.offsetHeight : 0 if(!data.vlayerOpts.lockScroll) { data.vlayerOpts.isBodyOverflow = false; document.body.style.overflow = ''; } props.***ximize && o***x.classList.remove('***ximized') vlayero.style.left = parseFloat(data.vlayerOpts.rect[0]) + 'px'; vlayero.style.top = parseFloat(data.vlayerOpts.rect[1]) + 'px'; vlayero.style.width = parseFloat(data.vlayerOpts.rect[2]) + 'px'; vlayero.style.height = parseFloat(data.vlayerOpts.rect[3]) + 'px'; } // 拖动|缩放弹窗 const move = () => { // ... } // 事件处理 const callback = () => { // 倒计时关闭 if(props.time) { $index++ // 防止重复点击 if($timer[$index] !== null) clearTimeout($timer[$index]) $timer[$index] = setTimeout(() => { close(); }, parseInt(props.time) * 1000) } } // 点击最大化按钮 const ***ximizeClicked = (e) => { let o = e.target if(o.classList.contains('***ximized')) { // 恢复 restore(); } else { // 最大化 full(); } } // 点击遮罩层 const shadeClicked = () => { if(JSON.parse(props.shadeClose)) { close(); } } // 按钮事件 const btnClicked = (e, index) => { let btn = props.btns[index] if(!btn.disabled) { typeof btn.click === 'function' && btn.click(e) } } return { ...toRefs(data), elRef, close, ***ximizeClicked, shadeClicked, btnClicked, } } }</script>

V3layer支持自定义拖拽区域(拖拽:’# aaa & # 8217)，将其拖出窗口(dragOut:true)。iframe弹出窗口类型(类型:’iframe & # 8217)。

Configure topmost:true当前窗口将保持在顶部。

ok，基于vue3.0开发pc端对话框组件就分享到这里。希望对大家有所帮助哈！好了，基于vue3.0开发的pc端对话框组件分享到这里。希望对大家有帮助！