Overlay 遮罩层
WebH5
遮罩层。fixed 全屏遮罩,支持背景模糊与自定义居中内容,显示时锁定 body 滚动。
何时使用
全局加载遮罩、自定义弹层的背景层、引导蒙层。
何时不使用
标准确认/表单弹窗直接用 Dialog;轻提示用 Toast。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | boolean | false | 显隐(v-model) |
zIndex | number | "var(--rn-z-index-overlay)" | 层级;不传则使用 overlay 层级 token |
blur | boolean | false | 背景模糊(backdrop-filter: blur(8px)) |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | boolean | 配合 v-model 更新显隐 |
click | MouseEvent | 点击遮罩时触发;是否关闭由调用方决定 |
Slots
| 名称 | 说明 |
|---|---|
default | 遮罩上的自定义内容,水平垂直居中 |
示例
基础
示例加载中…
<Button @click="show = true">显示遮罩</Button>
<Overlay v-model="show" @click="show = false" />自定义内容 + 模糊
示例加载中…
<Button @click="show = true">加载遮罩</Button>
<Overlay v-model="show" blur @click="show = false">
<Loading :size="36" color="var(--rn-color-text-inverse)" />
</Overlay>受控开合 + 关闭回显
示例加载中…
<Stack :gap="8">
<Button @click="show = true">打开遮罩(点背景关闭)</Button>
<Overlay v-model="show" @click="show = false; ev2 = '已点击遮罩关闭'" />
<span style="color:var(--rn-color-text-secondary);font-size:var(--rn-font-size-sm)">
{{ show ? '遮罩已打开' : (ev2 || '遮罩当前关闭') }}
</span>
</Stack>Playground
加载中…
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Overlay 文档(含手机预览)。