增强型 uniapp 全端弹出组件 | uni-app 自定义扩展弹出组件
最编程
2024-03-07 22:39:35
...
写在前面
目前在uniapp项目开发中,使用比较多的弹框是官方扩展的uni-popup
组件和uView-ui提供的u-popup
组件。使用过的都知道,功能有一些局限性。
今天主要给大家分享最新研发的uniapp增强版弹窗组件UAPopup。
如上图:编译到H5/小程序/App端效果。
支持多种弹窗类型及动画效果。组件式+函数式调用方式。可在Nvue页面完美运行显示。
引入组件
在main.js中全局引入组件。
import uaPopup from './components/ua-popup/index.vue'
Vue.component('ua-popup', uaPopup)
hbuilderx2.5 支持easycom
引入模式。根据需要也可以改为此种方式,无需手动注册引入。
调用组件
- 组件式
<!-- msg提示(自定义背景) -->
<ua-popup
v-model="showMsgBg"
anim="footer"
content="hello uniapp"
shade="false"
time="2"
:custom-style="{'backgroundColor': 'rgba(0,0,0,.6)', 'color': '#fff'}"
/>
<!-- 询问框 -->
<ua-popup v-model="showConfirm" shadeClose="false" title="标题" xclose z-index="2001"
content="<div style='color:#ff557f;padding:20px 40px;'>一切都将一去杳然,任何人都无法将其捕获。</div>"
:btns="[
{text: '取消', click: hideConfirm},
{text: '确定', style: 'color:#00aa00;', click: handleInfo},
]"
/>
- 函数式
// 函数式嵌套调用
handleInfo() {
let $ua = this.$refs.uapopup
let $toast = this.$refs.uatoast
$ua.open({
content: '人生漫漫,且行且珍惜',
customStyle: {'background-color': 'rgba(170, 0, 127, 0.6)', 'color': '#fff'},
time: 3,
onClose() {
$ua.open({
type: 'android',
content: '<div style="color:#aa007f">预测未来的最好办法是自己亲手创造未来</div>',
customStyle: {'width': '200px'},
zIndex: 202120,
btns: [
{
text: 'close', click() {
$ua.close()
}
},
{
text: 'Get一下',
style: 'color:#00aa00;',
click() {
$toast.open({
type: 'toast',
icon: 'loading',
content: '请稍后...',
opacity: .2,
time: 2,
zIndex: 202125,
})
}
}
]
})
}
})
},
handleBtnClick() {
this.$refs.uapopup.open({
content: '正在操作中,请稍后...',
shadeClose: false,
anim: 'footer',
customStyle: {'background-color': 'rgba(0, 170, 0, 0.6)', 'color': '#fff', 'border-radius': '6px'},
opacity: .1,
time: 2,
onClose: () => {
this.$refs.uatoast.open({
type: 'toast', icon: 'success', content: '操作成功', time: 2,
})
}
});
},
说明:对于一些复杂的弹窗场景,可以使用组件式,自定义内容插槽实现。一些简单的提示,则使用函数式即可。
<!-- msg提示 -->
<ua-popup v-model="showMsg" anim="fadeIn" content="上善若水,水利万物而不争" shadeClose="false" time="3" />
<!-- 自定义多按钮 -->
<ua-popup v-model="showMulityBtns" anim="fadeInDown" title="<b style='color:#03a9f4;'>Title</b>" :z-index="6666"
content="<div style='padding:10px 35px;'>Lately did you ever feel the pain In the morning as it soaks it to the bone?</div>"
:btns="[
{text: 'later', style: 'color:#aa557f;'},
{text: 'cancel', style: 'color:#ff5500;'},
{text: 'ok', style: 'color:#00aa00;', click: handleInfo},
]"
/>
<!-- 底部对话框 -->
<ua-popup v-model="showFooter" anim="footer" type="footer" :shadeClose="false"
content="真正觉悟的一刻,是放下追寻外在世界的财富,而开始追寻内心世界的真正财富。"
:btns="[
{text: 'Get到了', style: 'color:#00e0a1;', click: handleInfo},
{text: '收藏', style: 'color:#ee0a24;'},
{text: '取消', style: 'color:#a9a9a9;', click: hideFooter},
]"
/>
<!-- ActionSheet底部弹出式菜单(仿微信weui-picker顶部按钮) -->
<ua-popup v-model="showActionPicker" anim="footer" type="actionsheetPicker" round title="标题"
:btns="[
{text: '取消'},
{text: '确定', style: 'color:#00aa00;', click: handleInfo},
]"
>
<!-- 自定义内容 -->
<ul class="list" style="padding:50px;">
<li>只要不失去方向,就不会失去自我</li>
<li>别问别人为什么,多问自己凭什么</li>
<li>不要等待机会,而要创造机会</li>
</ul>
</ua-popup>
<ua-popup v-model="showToast" type="toast" icon="loading" time="2" content="加载中..." />
<ua-popup v-model="showToast" type="toast" icon="success" shade="false" time="2" content="成功提示" />
<ua-popup v-model="showToast" type="toast" icon="fail" shade="false" time="2" content="失败提示" />
<ua-popup v-model="showToast" type="toast" icon="warn" shade="false" time="2" content="提示" />
<ua-popup v-model="showToast" type="toast" icon="info" shade="false" time="2" content="普通提示" />
另外还支持类似微信长按弹窗效果。
<ua-popup v-model="showContextMenu2" type="contextmenu" :follow="follow2" opacity="0"
:btns="[
{text: '置顶联系人', click: handleContextPopup},
{text: '设置备注信息'},
{text: '星标好友'},
{text: '删除', click: hideContextMenu1},
]"
>
</ua-popup>
参数配置
支持超过20+参数配置。
## props [参数配置]
v-model 当前组件是否显示
title 标题(支持富文本div标签、自定义插槽内容)
content 内容(支持富文本div标签、自定义插槽内容)
type 弹窗类型(toast | footer | actionsheet | actionsheetPicker | android/ios)
customStyle 自定义弹窗样式
icon toast图标(loading | success | fail | warn | info)
shade 是否显示遮罩层
shadeClose 是否点击遮罩时关闭弹窗
opacity 遮罩层透明度
round 是否显示圆角
xclose 是否显示关闭图标
xposition 关闭图标位置(left | right | top | bottom)
xcolor 关闭图标颜色
anim 弹窗动画(scaleIn | fadeIn | footer | fadeInUp | fadeInDown)
position 弹出位置(top | right | bottom | left)
follow 长按/右键弹窗(坐标点)
time 弹窗自动关闭秒数(1、2、3)
zIndex 弹窗层叠(默认202107)
btns 弹窗按钮(参数:text|style|disabled|click)
------------------------------------------
## slot [插槽]
<template slot="title"></template>
<template slot="content"></template>
------------------------------------------
## emit
open 打开弹出层时触发(@open="xxx")
close 关闭弹出层时触发(@close="xxx")
------------------------------------------
## event
onOpen 打开弹窗回调
onClose 关闭弹窗回调
弹窗组件模板
<template>
<!-- #ifdef APP-NVUE -->
<view v-if="opts.visible" class="ua__popup" :class="{'ua__popup-closed': closeAnim}">
<!-- #endif -->
<!-- #ifndef APP-NVUE -->
<view v-show="opts.visible" class="ua__popup" :class="{'ua__popup-closed': closeAnim}">
<!-- #endif -->
<!-- 遮罩层 -->
<view v-if="opts.shade && opts.shade!='false'" class="uapopup__overlay" @touchstart="handleShadeClick" :style="{'opacity': opts.opacity >= 0 ? opts.opacity : '', 'z-index': oIndex-1}"></view>
<!-- 窗口层 -->
<view class="uapopup__wrap" :style="{'z-index': oIndex}">
<view class="uapopup__child" :id="'uapopup-'+uuid" :class="['anim-'+opts.anim, opts.type&&'popui__'+opts.type, opts.round&&'round', opts.position]" :style="[opts.follow&&positionStyle, opts.customStyle]">
<!-- //标题 -->
<view v-if="opts.title || $slots.title" class="uapopup__title">
<template v-if="$slots.title"><slot name="title" /></template>
<rich-text v-else :nodes="opts.title"></rich-text>
</view>
<!-- //toast -->
<!-- <view v-if="opts.type=='toast'&&opts.icon" class="toast__icons" :class="['toast__icons-'+opts.icon]" :style="{'background-image': `url(${toastIcon[opts.icon]})`}"></view> -->
<image v-if="opts.type=='toast'&&opts.icon" class="toast__icons" :class="['toast__icons-'+opts.icon]" :src="toastIcon[opts.icon]" mode="widthFix"></image>
<!-- //内容 -->
<view v-if="opts.content || $slots.content" class="uapopup__content">
<template v-if="$slots.content"><slot name="content" /></template>
<rich-text v-else :nodes="opts.content"></rich-text>
</view>
<slot />
<!-- //按钮组 -->
<view v-if="opts.btns" class="uapopup__actions">
<rich-text v-for="(btn,index) in opts.btns" :key="index" class="btn" :class="{'disabled': btn.disabled}" :style="btn.style" @click="handleBtnClick($event, index)" :nodes="btn.text"></rich-text>
</view>
<!-- //关闭按钮 -->
<view v-if="opts.xclose" class="uapopup__xclose" :class="opts.xposition" :style="{'color': opts.xcolor}" @click="close"></view>
</view>
</view>
</view>
</template>
/**
* @Desc uniapp全端自定义弹框组件
* @Time andy by 2021/7/10
* @About Q:282310962 wx:xy190310
*/
<script>
let index = 0
export default {
...
data() {
return {
// 混入props参数,处理函数式调用
opts: {
visible: false,
},
toastIcon: {
...
},
closeAnim: false,
oIndex: 202107,
timer: null,
// 长按定位初始化(避免弹框跳动闪烁)
positionStyle: { position: 'absolute', left: '-999px', top: '-999px' },
}
},
watch: {
value(val) {
const type = val ? 'open' : 'close'
this[type]()
}
},
computed: {
uuid() {
return Math.floor(Math.random() * 10000)
},
},
methods: {
// 打开弹框
open(options) {
if(this.opts.visible) return
this.opts = Object.assign({}, this.$props, options)
this.opts.visible = true
// nvue 的各组件在安卓端默认是透明的,如果不设置background-color,可能会导致出现重影的问题
// #ifdef APP-NVUE
if(!this.opts.customStyle['background'] && !this.opts.customStyle['background-color']) {
this.opts.customStyle['background'] = '#fff'
}
// #endif
let _index = ++index
this.oIndex = _index + parseInt(this.opts.zIndex)
this.$emit('open')
typeof this.opts.onOpen === 'function' && this.opts.onOpen()
// 长按处理
if(this.opts.follow) {
...
}
...
},
// 关闭弹框
close() {
if(!this.opts.visible) return
this.closeAnim = true
setTimeout(() => {
this.opts.visible = false
this.closeAnim = false
this.$emit('input', false)
this.$emit('close')
typeof this.opts.onClose === 'function' && this.opts.onClose()
this.timer && clearTimeout(this.timer)
delete this.timer
}, 200)
},
...
// 获取dom宽高
getDom(id) {
return new Promise((resolve, inject) => {
uni.createSelectorQuery().in(this).select('#uapopup-' + id).fields({
size: true,
}, data => {
resolve(data)
}).exec()
})
},
// 自适应坐标点
getPos(x, y, ow, oh, winW, winH) {
let l = (x + ow) > winW ? x - ow : x;
let t = (y + oh) > winH ? y - oh : y;
return [l, t];
},
}
}
</script>
ok,基于uni-app跨端自定义弹窗组件就分享到这里。感谢大家的阅读~~
https://cloud.tencent.com/developer/article/1825924
推荐阅读
-
UniApp+vue3+call Gaode map js Api2.0
-
NLP 信息提取全解:从命名实体到事件提取的 PyTorch 实用指南
-
Blazor 中的 PageTitle 输出关键字和描述,自定义组件
-
超越边界:扩展大型模型的应用领域,探索文本分类、文本匹配、信息提取和人格测试等多领域应用
-
在 uniapp 中展开和折叠文本
-
桌面太单调?用 Python 制作自定义动态壁纸,竟然还能播放视频!
-
Vue3 自定义指令只能输入数字
-
人工智能大模型探索路径-培训第 11 部分:大语言模型转换器库-模型组件实践
-
阿里云网络客户端企业版代码 - 小结
-
Nat.用于全基因组药物重新定位的系统网络算法