# wxc-mask 

> 一个提供关闭按钮的Weex Mask弹窗组件，可以定制content里面的内容。

-----

## [Demo预览](https://h5.m.taobao.com/trip/wxc-mask/index.html?_wx_tpl=https%3A%2F%2Fh5.m.taobao.com%2Ftrip%2Fwxc-mask%2Fdemo%2Findex.native-min.js)
<img src="https://img.alicdn.com/tfs/TB1i4vhSpXXXXcAaXXXXXXXXXXX-750-1334.gif" width="240"/>&nbsp;&nbsp;&nbsp;&nbsp;<img src="http://gtms03.alicdn.com/tfs/TB1CgYJSpXXXXc5aXXXXXXXXXXX-200-200.png" width="160"/>

## 安装

```
npm i weex-ui --save
```

## 使用方法

```
<template>
  <div class="wrapper">
    <div class="btn" @click="openMask">
      <text class="btn-txt">点击弹出动画面板</text>
    </div>
    <div class="btn btn-margin yellow" @click="openNoAnimationMask">
      <text class="btn-txt">点击弹出无动画面板</text>
    </div>
    <wxc-mask height="800"
              width="702"
              overlay-opacity="0.6"
              border-radius="0"
              duration="200"
              mask-bg-color="#FFFFFF"
              :overlay-can-close="overlayCanClose"
              :has-animation="hasAnimation"
              :has-overlay="hasOverlay"
              :show-close="showClose"
              v-on:wxcMaskSetHidden="wxcMaskSetHidden"
              :show="show">
      <div class="content">
        <div class="demo-title">
          <text class="title">Weex帮助你构建原生应用</text>
        </div>
        <text class="content-text">
          与 Web App、HTML5 App 或 hybrid App 不同，您可以使用 Weex 构建一个真正的原生应用。更贴心的是你的代码只需使用 HTML、CSS、JavaScript
          可以构建原生应用，上手非常简单。但实际上，应用的底层是 Objective-C 或 Java， 同时，Weex 提供很多 native 组件或模块供开发人员使用。
        </text>
      </div>
    </wxc-mask>
  </div>
</template>

<script>
  import { WxcMask } from 'weex-ui';
  const navigationBar = weex.requireModule('navigationBar');
  module.exports = {
    components: { WxcMask },
    data: () => ({
      show: false,
      showClose: true,
      hasOverlay: true,
      overlayCanClose: true,
      isFalse: false,
      hasAnimation: true
    }),
    methods: {
      openMask (e) {
        this.show = true;
        this.hasAnimation = true;
      },
      wxcMaskSetHidden () {
        this.show = false;
      },
      openNoAnimationMask (e) {
        this.show = true;
        this.hasAnimation = false;
      }
    }
  };
</script>
```

### 可配置参数

| 名称      | 类型     | 默认值   | 备注  |
|-------------|------------|--------|-----|
| show | `Bool` | false |  设置mask是否显示 |
| width | `Number` | 702 | 面板的宽度  |
| height | `Number` | 800 | 面板的高度  |
| has-animation | `Bool` | true | 面板弹出是否动画 |
| show-close | `Bool` | false |  是否显示关闭按钮 |
| has-overlay | `Bool` | true |  是否有蒙层 |
| border-radius | `Number` | 0 |  弹出的border-radius |
| overlay-can-close | `Bool` | true |  点击overlay灰层是否可以关闭 |
| mask-bg-color | `String` | '#ffffff' |  mask的背景颜色 |
| duration | `String` | '300' |  弹层出现时间 |
| timing-function | `String` | 'ease-in' |  弹层出现动画方式 |
| overlay-cfg | `Object` | '{ hasAnimation: true, timingFunction: ['ease-in', 'ease-out'], duration: 300, opacity: 0.6 }' |  蒙层配置参数，参考[wxc-overlay]组件 |


### 事件回调

```
//有一个关闭相关的回调逻辑` v-on:wxcMaskSetHidden="wxcMaskSetHidden"`，需要设置`show=false`
//详细可见demo
//此外还有`v-on:wxcMaskCloseClick="wxcMaskCloseClick"`、` v-on:wxcOverlayBodyClicked="wxcOverlayBodyClicked"`需要时候可以使用
```