m-overlay 遮罩层

简述

遮罩层，弹出框的蒙层。

注意

请以 uni_modules/m-unix 与本文为准；各端差异以 uni-app 与各平台官方文档为准。涉及隐私能力（相册、定位、剪贴板、手机号等）需在 manifest 与后台完成配置。

平台差异说明

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

演示地址

与线上 H5 演示基座 分包一致（文档站右下角预览 iframe 亦指向同一路径）。

类型	地址
分包路径	pages_demo/popup/popup
线上 H5（hash）	打开演示

基本使用

<template>
	<view>
		<m-overlay :show="show" @click="close"></m-overlay>
	</view>
</template>

Props

参数	说明	类型	默认值
show	是否显示	boolean	false
opacity	黑色遮罩不透明度（与 rgba(0,0,0,α) 中的 α 一致）	number | string	0.5
zIndex	层级	number | string	998
lockScroll	是否锁定背景滚动	boolean	true
durationMs	淡入淡出时长（毫秒），与 m-popup 的 duration 对齐	number	300

Events

事件名	说明	回调参数
click	点击遮罩	原生事件

示例

基础用法

<m-overlay
	:show="showPopup"
	@click="showPopup = false"
></m-overlay>

自定义透明度

<m-overlay
	:show="show"
	:opacity="0.8"
></m-overlay>