Warning: Illegal string offset 'name' in D:\wwwroot\yixaonet\wp-content\themes\exou\themer\functions\shortcodes-render.php on line 40
Warning: Illegal string offset 'name' in D:\wwwroot\yixaonet\wp-content\themes\exou\themer\functions\shortcodes-render.php on line 40
今天给大家分享的是Vue3系列之自定义桌面端对话框组件v3layer。
V3Layer 基于vue3.0构建的多功能PC网页端弹窗组件。拥有超过10 种弹窗类型、30 种参数配置,支持拖拽(自定义拖拽区域)、缩放、最大化、全屏及自定义置顶层叠等功能。
快速引入
在main.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\'
// 引入弹窗组件v3layer
import V3Layer from \'./components/v3layer\'
createApp(App).use(ElementPlus).use(V3Layer).mount(\'#app\')
v3layer支持组件式 函数式两种调用方式。
- 组件式
<v3-layer
v-model="showDialog"
title="标题内容"
content="
这里是内容信息!
"
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: \'
这里是内容信息!
\',
shadeClose: false,
zIndex: 2021,
lockScroll: false,
xclose: true,
resize: true,
dragOut: true,
btns: [
{text: \'取消\', click: () => { $el.close() }},
{text: \'确认\', click: () => handleSure},
]
});
当弹窗类型为 message | notify | popover,调用方法如下:
v3layer.message({...})
v3layer.notify({...})
v3layer.popover({...})
vue3.0中提供了app.config.globalProperties 或 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\']
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弹窗模板
<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">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>
<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">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="!maximize&&xposition" :style="{\'color\': xcolor}" @click="close">span>
<span v-if="maximize" class="vlayer__maximize" @click="maximizeClicked($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 omax = dom.querySelector(\'.vlayer__maximize\');
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 = \'\';
omax && omax.classList.contains(\'maximized\') && omax.classList.remove(\'maximized\');
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 omax = dom.querySelector(\'.vlayer__maximize\');
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.maximize && omax.classList.remove(\'maximized\')
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 maximizeClicked = (e) => {
let o = e.target
if(o.classList.contains(\'maximized\')) {
// 恢复
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,
maximizeClicked,
shadeClicked,
btnClicked,
}
}
}
script>
v3layer支持自定义拖拽区域 (drag:\’#aaa\’),拖动到窗口外 (dragOut:true)。支持iframe弹窗类型 (type:\’iframe\’)。
配置 topmost:true 当前窗口会保持置顶。
ok,基于vue3.0开发pc端对话框组件就分享到这里。希望对大家有所帮助哈!
内容出处:,
声明:本网站所收集的部分公开资料来源于互联网,转载的目的在于传递更多信息及用于网络分享,并不代表本站赞同其观点和对其真实性负责,也不构成任何其他建议。如果您发现网站上有侵犯您的知识产权的作品,请与我们取得联系,我们会及时修改或删除。文章链接:http://www.yixao.com/share/18827.html