ayer.js是一個方便的彈出層插件,切圖網專注于PSD2HTML等前端切圖多年,后轉向Vue開發。在vue開發過程中引入layer.js的時候遇到了麻煩。原因是layer.js不支持import導入,這時就需要修改一下它的源碼。在看過它的源碼后,發現需要修改的地方只有兩處,
源碼中已經暴露了一個全局變量layer,故只需在腳本末尾處添加
export default layer;
這表示將這個全局變量導出。
然后在文件中找到下面的代碼注釋掉,這段代碼是為layer添加樣式的,但使用的路徑不對,故沒有太大幫助。
document.head.appendChild(function() {
var link=doc.createElement('link');
link.href=path + 'need/layer.css?2.0';
link.type='text/css';
link.rel='styleSheet'link.id='layermcss';
return link;
} ());
接下來把layer.js和layer.css分別放入static/js和static/css中,在需要的地方,比如組件內部或者全局注冊,因為項目多處都會用到,所以采用全局注冊,在main.js中
import layer from '../static/js/layer.js'
layer.css也使用全局注冊,它可以放在index.html中通過link引入,也可以放在App.vue中
<!--index.html-->
<link rel="stylesheet" href="./static/css/layer.css" />
<!--或者-->
<!--App.vue-->
<style>
@import "../static/css/layer.css";
</style>
接下來就能在各個組件中使用layer.open等方法了。
這種方式應該可以適用于各種不支持import導入的腳本,即非npm提供的module。
天給大家分享的是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="<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},
]
});
當彈窗類型為 message | notify | popover,調用方法如下:
v3layer.message({...})
v3layer.notify({...})
v3layer.popover({...})
vue3.0中提供了app.config.globalProperties 或 app.provide 兩種方式掛載全局函數。
// vue2中調用
methods: {
showDialog() {
this.$v3layer({...})
}
}
// vue3中調用
setup() {
// 獲取上下文
const { ctx }=getCurrentInstance()
ctx.$v3layer({...})
}
// 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[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="!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端對話框組件就分享到這里。希望對大家有所幫助哈!
起養成寫作習慣!這是我參與「掘金日新計劃 · 4 月更文挑戰」的第1天,點擊查看活動詳情。 layui是大家眾所周知的一款ui框架 下面組要給大家講一講layui的彈層組件layer 基礎參數
我們提到的基礎參數主要指調用方法時用到的配置項,如:layer.open({content: ''}) layer.msg('', {time: 3}) 等,其中的content和time即是基礎參數,以鍵值形式存在,基礎參數可合理應用于任何層類型中,您不需要所有都去配置,大多數都是可選的。而其中的layer.open、layer.msg就是內置方法。注意,從2.3開始,無需通過layer.config來加載拓展模塊
*請認真填寫需求信息,我們會在24小時內與您取得聯系。