更新记录

2.1.3(2021-10-13) 下载此版本

  • 修改微信小程序环境下关闭按钮显示样式问题。

2.1.2(2021-10-13) 下载此版本

  • 修复小程序开发工具不能正常使用问题。

2.1.1.1(2021-10-13) 下载此版本

  • 修改文档说明
查看更多

平台兼容性

uni-app

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
- - - -
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 快应用-华为 快应用-联盟
- - - -

其他

多语言 暗黑模式 宽屏模式
× ×

Mask 蒙版

组件名:dm-mask 代码块: dmMask

视图蒙版组件。

安装方式

本组件符合easycom规范,HBuilderX 2.5.5起,只需将本组件导入项目,在页面template中即可直接使用,无需在页面中import和注册components

基本用法

template 中使用组件

复制代码<dm-mask :show="true"></dm-mask>
<dm-mask :show.sync="show"></dm-mask>
<dm-mask :show.sync="show" width="50%" height="50%"  background-color="red" :z-index="99" closable></dm-mask>
<dm-mask :show.sync="show" :custom-style="{fontSize: '50px', color: 'red', padding: '15px 15px'}"></dm-mask>
<dm-mask :show.sync="show" @on-click="clickMask"></dm-mask>
<dm-mask :show.sync="show" @on-click="clickMask">
    <button type="default" @click.stop="clickButton()">点击</button>
</dm-mask>

注意:

  • 如果给mask添加了点击事件,则在它内部的元素如果也存在点击事件,为了防止事件冒泡触发,需要使用.stop事件修饰符来解决事件冒泡可能触发的多重点击问题。

API

Mask Props

属性 类型 默认值 必填 说明
show Boolean false 是否显示,默认true显示,false不显示。需要使用.sync双向绑定,否则改变状态时并不能改变使用者的数据
width String 100% 宽度
height String 100% 高度
background-color String rgba(0, 0, 0, 0.5) 背景颜色
z-index String 99 元素的堆叠顺序,数值越大,会覆盖在较小的元素的上层进行显示
custom-style Object {} 自定义 Mask 样式,样式对象语法
closable Boolean false false 是否显示关闭按钮,默认值false不显示,true显示

说明:

  • 这里z-index属性设置值超过997后为全屏蒙版(将会遮盖状态栏),将会覆盖状态栏。当值小于等于997,将不遮盖状态栏,在状态栏下形成蒙版。所以在开发中请合理设置z-index值大小,这里默认值为99,不会覆盖状态栏。如不需要全屏蒙版,则不需要重新设置z-index值大小。

Mask Events

事件名 事件说明 返回参数
@on-click 点击 Mask 触发事件 -

Mask Slots

Mask 支持插槽,直接在mask组件内部进行视图编辑

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议
747***@qq.com

2022-09-18

uni开发微信小程序中z-index设置后也不能遮挡状态栏,怎么回事呢??

286***@qq.com

2022-04-21

怎么设置蒙版下面的内容不可滑动,而蒙版上面的内容可以滚动

ren***@foxmail.com

2021-10-29

z-index 999 app-vue 下不能覆盖状态栏,H5可以

doublem 2021-11-02

感谢你的反馈,可以试试将这个值再往大的设置,如果还是不行,那就是在这个模式下状态栏的层级是最高的,不能通过z-index来控制层级。

459***@qq.com

2021-10-06

插件引进去在H5上能实现,但是在微信小程序上就不行了

doublem 2021-10-13

感谢你的反馈,问题已经修复;更新后使用。

zhu***@qq.com

2021-09-04

关闭按钮修改的不是show的值,而是closed的值,我想使用关闭按钮,关了就打不开了。如果不用关闭按钮,之内的输入框一点就关闭了,纠结

doublem 2021-09-07

谢谢你的反馈,问题已经修复;更新后使用。

doublem

2021-08-11

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问