Skip to content

Backdrop 遮罩层 ​

用于覆盖页面内容,可通过点击事件通知父组件关闭遮罩。

支持平台 ​

以下为官网文档所列的平台支持情况,具体功能及版本限制请参见本页的平台说明。

App-vueApp-nvue微信小程序支付宝小程序百度小程序字节小程序QQ小程序H5PC快手小程序钉钉小程序
✓✓✓✓✓✓✓✓✓✓✓

基础用法 ​

vue
<!-- 点击遮罩后更新显示状态 -->
<fui-backdrop :show="showMask" closable @click="showMask = false" />

在页面数据中声明 showMask,通过改变该值控制显示。

属性 ​

属性类型说明官网默认值
showBoolean是否显示遮罩false
backgroundString遮罩背景色rgba(0, 0, 0, 0.6)
absoluteBoolean是否使用绝对定位,否则使用固定定位false
fullBoolean根元素下绝对定位时是否铺满屏幕,仅 nvue 有效false
zIndexNumber遮罩层级,nvue 不支持980
closableBoolean是否允许点击遮罩触发事件false

事件 ​

事件说明回调参数
clickclosable 为 true 时点击遮罩触发,由父组件更新 show无

插槽 ​

插槽说明
default遮罩内部内容

平台说明 ​

非 nvue 平台本地 background 属性默认为空,可通过 --fui-bg-color-mask 调整背景。nvue 中元素先后顺序影响层级。