success品牌logo


success品牌logo  

今天我要给大家介绍的是Vue 3系列的自定义桌面端对话框组件——V3Layer。

V3Layer是一个基于vue3.0构建的PC网页端弹窗组件,具有丰富的功能,支持超过10种弹窗类型和超过30种参数配置。这个组件提供了拖拽(自定义拖拽区域)、缩放、最大化、全屏以及自定义置顶层级等功能。

快速集成步骤:

在项目的main.js文件中引入v3layer组件以及其他必要的库。

javascript

import { createApp } from 'vue';

import App from './App.vue';

import ElementPlus from 'element-plus';

import 'element-plus/lib/theme-chalk/index.css';

import V3Layer from './components/v3layer';

createApp(App).use(ElementPlus).use(V3Layer).mount('app');

V3Layer支持两种调用方式:组件式和函数式。

组件式调用示例:

v-model="showDialog"

title="标题内容"

content="这里是内容信息!"

z-index="2021"

lockScroll="false"

xclose

resize

dragOut

:btns="[...]">

这里是自定义插槽内容信息!

函数式调用示例:

javascript

let $el = v3layer({

// 参数配置...

});

对于特定的弹窗类型如message、notify和popover,调用方式如下:

javascript

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等)

position:弹出位置(可以是自动或指定位置,如t、r、b、l等)

drawer:抽屉弹窗(包括top、right、bottom、left等方向)

follow:跟随元素定位弹窗(允许用户指定跟随的元素定位弹窗)

time:弹窗自动关闭秒数(定义弹窗自动关闭的时间)

zIndex:弹窗层叠(定义弹窗的层叠顺序)

teleport:指定挂载节点(允许用户指定弹窗挂载的节点)

topmost:置顶当前窗口(控制弹窗是否置顶显示)

area:弹窗宽高(定义弹窗的宽度和高度)

maxWidth:弹窗最大宽度(定义弹窗的最大宽度限制)

maximize:是否显示最大化按钮(控制最大化按钮的显示与隐藏)

fullscreen:全屏弹窗(允许弹窗全屏显示)

fixed:弹窗是否固定(定义弹窗的位置是否固定)

drag:拖拽元素(允许用户定义可拖拽的元素,可以使用选择器如'.xxx'或禁止拖拽设置为'false')

dragOut:是否允许拖拽到窗口外(控制是否可以将弹窗拖拽到窗口外部)

lockAxis:限制拖拽方向(可选垂直或水平方向限制拖拽)

resize:是否允许拉伸尺寸(控制是否允许用户拉伸弹窗的尺寸)

btns:弹窗按钮(定义弹窗的按钮,包括文字、样式、禁用状态和点击事件)

事件触发和事件:

success:层弹出后回调事件(在弹框成功弹出后触发的回调函数)

end:层销毁后回调事件(在弹框销毁后触发的回调函数)

onSuccess:层打开回调事件(弹框打开时的回调函数)

onEnd:层关闭回调事件(弹框关闭时的回调函数)

关于支持iframe弹窗类型的使用(采用'iframe'类型)。在配置中设置topmost为true,这将使得当前窗口始终保持置顶状态。今天在这里分享一下基于vue3.0开发的pc端对话框组件的用法和设置,希望能给大家带来一些帮助和启示。在使用过程中,可以根据自身需求进行相应的调整和优化,以达到更好的用户体验效果。希望这篇文章能为大家提供一些有价值的参考和建议。

  success品牌logo