doc.md 1.5 KB
Newer Older
S
suzigang 已提交
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24
# overlay 组件

### 介绍

创建一个遮罩层,通常用于阻止用户进行其他操作

### 安装

```javascript
import { createApp } from 'vue';
import { OverLay } from '@nutui/nutui';

const app = createApp();
app.use(OverLay);
```

## 代码演示

### 基础用法

```html
<nut-overlay v-model:show="state.show" :z-index="2000"></nut-overlay>
```

S
suzigang 已提交
25
### 嵌套内容
S
suzigang 已提交
26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54

```html
<nut-overlay v-model:show="state.show2" :z-index="2000">
  <div class="wrapper">
    <div class="content">这里是正文</div>
  </div>
</nut-overlay>
```

## API

### Props

| 参数                   | 说明             | 类型           | 默认值 |
| ---------------------- | ---------------- | -------------- | ------ |
| show                   | 当前组件是否显示 | Boolean        | false  |
| z-index                | 遮罩层级         | String、Number | 2000   |
| duration               | 动画时长,单位秒 | String、Number | 0.3    |
| overlay-class          | 自定义遮罩类名   | String         | -      |
| overlay-style          | 自定义遮罩样式   | CSSProperties  | -      |
| lock-scroll            | 背景是否锁定     | Boolean        | false  |
| overlay                | 是否显示遮罩     | Boolean        | true   |
| close-on-click-overlay | 是否点击遮罩关闭 | Boolean        | true   |

### Events

| 事件名 | 说明       | 回调参数     |
| ------ | ---------- | ------------ |
| click  | 点击时触发 | event: Event |