更新记录

2.1.3(2021-10-13)

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

2.1.2(2021-10-13)

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

2.1.1.1(2021-10-13)

  • 修改文档说明
查看更多

平台兼容性

Vue2 Vue3
×
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
app-vue app-nvue
钉钉小程序 快手小程序 飞书小程序 京东小程序
× × × ×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari

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协议

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