跳到主要内容

Overlay 遮罩层 ​

WebH5

遮罩层。fixed 全屏遮罩,支持背景模糊与自定义居中内容,显示时锁定 body 滚动。

何时使用 ​

全局加载遮罩、自定义弹层的背景层、引导蒙层。

何时不使用 ​

标准确认/表单弹窗直接用 Dialog;轻提示用 Toast。

Props ​

名称类型默认值说明
modelValuebooleanfalse显隐(v-model)
zIndexnumber"var(--rn-z-index-overlay)"层级;不传则使用 overlay 层级 token
blurbooleanfalse背景模糊(backdrop-filter: blur(8px))

Events ​

名称载荷说明
update:modelValueboolean配合 v-model 更新显隐
clickMouseEvent点击遮罩时触发;是否关闭由调用方决定

Slots ​

名称说明
default遮罩上的自定义内容,水平垂直居中

示例 ​

基础 ​

示例加载中…

自定义内容 + 模糊 ​

示例加载中…

受控开合 + 关闭回显 ​

示例加载中…

Playground ​

加载中…

跨端版本 ​

该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Overlay 文档(含手机预览)。