# 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
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
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时触发 | - |
示例预览
# 示例代码地址
← Toast 轻提示 Dialog 对话框 →