# Backdrop 遮罩层

概述

Backdrop 遮罩层,在组件中设置显示蒙层。

# 支持平台

App-vue App-Nvue 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序 H5 PC 快手小程序 钉钉小程序

温馨提示

一般来说我们会通过 z-index + position 来进行层级的设置,但是 weex (Nvue)不支持 z-index 设置层级关系,默认越靠后的元素层级越高。

# 引入

以下介绍两种常用的引入方式。
第一种:在页面中引用、注册
import fuiBackdrop from "@/components/firstui/fui-backdrop/fui-backdrop.vue"
export default {
	components:{
		fuiBackdrop
	}
}
1
2
3
4
5
6
第二种:easycom组件规范
传统vue组件,需要安装、引用、注册,三个步骤后才能使用组件。easycom将其精简为一步。

First UI easycom配置请查看 快速上手

如果不了解easycom,可先查看 官网文档 (opens new window)

# 代码演示

部分示例演示,完整使用请参考示例程序以及文档API。
基础使用

通过 show 属性设置遮罩层显示隐藏,closable 属性设置是否可以点击遮罩层进行关闭。

<!--closable为true时click事件才生效-->
<fui-backdrop :show="show" closable @click="close"></fui-backdrop>
1
2

# Slots

插槽名称 说明
default 标签内部自定义内容

# Props

属性名 类型 说明 默认值 平台差异说明
show Boolean 是否显示遮罩层 false -
background String 遮罩层背景颜色 rgba(0, 0, 0, 0.6) 非Nvue端默认值为空,可通过css变量(--fui-bg-color-mask)改变背景颜色
absolute Boolean 是否绝对定位,默认为固定定位fixed false -
full V1.6.0+ Boolean absolute定位且组件在根元素下时是否铺满屏幕 false 仅Nvue端有效
zIndex Number 遮罩层z-index值 980 Nvue端不支持,默认越靠后的元素层级越高
closable Boolean 是否可点击遮罩层,设为true后点击事件生效 false -

# Events

事件名 说明 回调参数
@click 点击遮罩层且closable设为true时触发 -

示例预览

# 示例代码地址

FirstUIBackdrop 遮罩层
Last Updated: 1/10/2024, 6:25:05 PM