Skip to content

Overlay 遮罩层 ​

查看 sn-overlay 的 2.0 版本差异

基础用法 ​

全屏遮罩层,用于强调特定元素或拦截页面交互,常与弹出层、模态框搭配使用。

  • 遮罩内插槽可放置任意内容
  • 点击遮罩区域默认关闭
  • 通过组件方法控制显隐,层级固定

必须放在 sn-page 下

本组件为弹出层,需直接放在 sn-page 根节点下使用,否则主题颜色与动画时长等 CSS 变量无法作用到组件内部。

vue
<template>
	<sn-page>
		<sn-button text="打开遮罩" type="primary" @click="open"></sn-button>
		<sn-overlay ref="overlayEle">
			<view class="content">
				<sn-text text="遮罩内容"></sn-text>
			</view>
		</sn-overlay>
	</sn-page>
</template>

更多演示请下载 demo 查看

属性 ​

参数说明类型默认值可选值
maskClose点击遮罩区域是否关闭遮罩层Booleantruetrue | false
opacity遮罩层透明度Number0.4-
aniTime动画时长(ms),支持 $ 前缀按动画乘数缩放,0 时瞬时显隐String | Number$long$long | $normal | $short | 数值
bgColor遮罩背景颜色,支持 $ 简写主题色String#000-
customStyle自定义遮罩根节点样式SnStyleValue''-

事件 ​

名称类型说明
open() => Void打开时触发
close() => Void关闭时触发
click-mask() => Void点击遮罩区域时触发

方法 ​

名称参数返回值描述
open--打开遮罩层
close--关闭遮罩层

插槽 ​

名称说明
default遮罩层内容

使用 MIT 协议