CNCEC_APP/uni_modules/uview-pro/components/u-mask/u-mask.vue

114 lines
3.1 KiB
Vue
Raw Normal View History

2026-03-25 14:54:15 +08:00
<template>
<view
class="u-mask"
hover-stop-propagation
:style="$u.toStyle(maskStyle, zoomStyle, customStyle)"
@tap="click"
@touchmove.stop.prevent="() => {}"
:class="[
{
'u-mask-zoom': props.zoom,
'u-mask-show': props.show
},
customClass
]"
>
<slot />
</view>
</template>
<script lang="ts">
export default {
name: 'u-mask',
options: {
addGlobalClass: true,
// #ifndef MP-TOUTIAO
virtualHost: true,
// #endif
styleIsolation: 'shared'
}
};
</script>
<script setup lang="ts">
import { ref, computed, watch } from 'vue';
import { $u } from '../..';
import { MaskProps } from './types';
/**
* mask 遮罩
* @description 创建一个遮罩层用于强调特定的页面元素并阻止用户对遮罩下层的内容进行操作一般用于弹窗场景
* @tutorial https://uviewpro.cn/zh/components/mask.html
* @property {Boolean} show 是否显示遮罩默认false
* @property {String|Number} z-index z-index 层级默认1070
* @property {Object} custom-style 自定义样式对象见上方说明
* @property {String|Number} duration 动画时长单位毫秒默认300
* @property {Boolean} zoom 是否使用scale对遮罩进行缩放默认true
* @property {Boolean} mask-click-able 遮罩是否可点击为false时点击不会发送click事件默认true
* @event {Function} click mask-click-able为true时点击遮罩发送此事件
* @example <u-mask :show="show" @click="show = false"></u-mask>
*/
const props = defineProps(MaskProps);
const emit = defineEmits(['click']);
// 缩放动画样式
const zoomStyle = ref<{ transform: string }>({ transform: '' });
// scale值
const scale = 'scale(1.2, 1.2)';
// 监听遮罩显示状态,动态设置缩放动画
watch(
() => props.show,
n => {
if (n && props.zoom) {
// 当展示遮罩的时候设置scale为1达到缩小(原来为1.2)的效果
zoomStyle.value.transform = 'scale(1, 1)';
} else if (!n && props.zoom) {
// 当隐藏遮罩的时候设置scale为1.2,达到放大(因为显示遮罩时已重置为1)的效果
zoomStyle.value.transform = scale;
}
}
);
// 遮罩样式
const maskStyle = computed(() => {
let style: Record<string, any> = {};
style.backgroundColor = 'rgba(0, 0, 0, 0.6)';
if (props.show) style.zIndex = props.zIndex ? props.zIndex : $u.zIndex.mask;
else style.zIndex = -1;
style.transition = `all ${Number(props.duration) / 1000}s ease-in-out`;
return style;
});
/**
* 遮罩点击事件
* maskClickAble为true时点击遮罩发送click事件
*/
function click() {
if (!props.maskClickAble) return;
emit('click');
}
</script>
<style lang="scss" scoped>
@import '../../libs/css/style.components.scss';
.u-mask {
position: fixed;
top: 0;
left: 0;
right: 0;
bottom: 0;
opacity: 0;
transition: transform 0.3s;
}
.u-mask-show {
opacity: 1;
}
.u-mask-zoom {
transform: scale(1.2, 1.2);
}
</style>