uv-ui

# Overlay 遮罩层

✈

组件名：uv-overlay

点击下载&安装 (opens new window)

创建一个遮罩层，用于强调特定的页面元素，并阻止用户对遮罩下层的内容进行操作，一般用于弹窗场景，uv-popup、uv-toast、uv-tooltip等组件就是用了该组件

# 平台兼容性

App（vue） App（nvue） H5 小程序 VUE2 VUE3
√ √ √ √ √ √

# 基本使用

  • 通过show参数配置是否显示遮罩
  • 遮罩被点击时，会发送一个click事件，如不需要此事件，请设置mask-click-able参数为false
<template>
	<uv-overlay :show="show" @click="show = false"></uv-overlay>
</template>
<script>
	export default {
		data() {
			return {
				show: true
			}
		}
	}
</script>

# 嵌入内容

通过默认插槽可以在遮罩层上嵌入任意内容
注意：如果不想让slot插槽内容的点击事件冒泡到遮罩，请给指定元素添加上@tap.stop

<template>
	<uv-overlay :show="show" @click="show = false">
		<view class="warp">
			<view class="rect" @tap.stop></view>
		</view>
	</uv-overlay>
</template>
<script>
	export default {
		data() {
			return {
				show: true
			}
		}
	}
</script>
<style scoped>
	.warp {
		display: flex;
		align-items: center;
		justify-content: center;
		height: 100%;
	}

	.rect {
		width: 120px;
		height: 120px;
		background-color: #fff;
	}
</style>

# 遮罩样式

  • 通过duration设置遮罩淡入淡出的时长，单位ms
<uv-overlay :show="true" :duration="400" :z-index ="999" :opacity="0.3"></uv-overlay>

# 完整示例

完整示例下载地址

https://ext.dcloud.net.cn/plugin?name=uv-ui (opens new window)

# API

# Overlay Props

参数 说明 类型 默认值 可选值
show 是否显示遮罩 Boolean false true | false
zIndex z-index层级 String | Number 10070 -
duration 动画时长，单位毫秒ms String | Number 300 -
opacity 不透明度值，当做rgba的第四个参数 String | Number 0.5 -

# Overlay Events

事件名 说明 回调参数
@click 点击遮罩发送此事件 -

# Overlay Slots

名称 说明
default 默认插槽，用于在遮罩层上方嵌入内容

← CodeInput 验证码输入 →