## 基础弹框dialog
<br />
用于弹出一个对话框,可自定义弹窗内容

### 基本用法

:::demo `show`用于控制弹窗展示与否
```html
<template>
    <div>
        <el-button @click="show=true;">
            打开弹窗
        </el-button>
        <ve-dialog :show.sync="show">
            <h1>
                我是内容
            </h1>
        </ve-dialog>    
    </div>
</template>

<script>
    export default {
        data() {
            return {
                show : false
            }
        }
    }
</script>

```
:::


### 添加footer
自定义设置是否需要底部操作按钮及操作按钮内容

:::demo 通过具名slot可设置footer。
```html
<template>
    <div>
        <el-button @click="show=true;">
            打开弹窗
        </el-button>
        <ve-dialog :show.sync="show" title="我是弹窗标题" :showClose="false">
            <div>
                我是弹窗内容123
            </div>
            <span slot="footer">
                <el-button @click="hide">
                    取 消
                </el-button>
                <el-button type="primary">
                    确 定
                </el-button>
		    </span>
        </ve-dialog>    
    </div>
</template>

<script>
    export default {
        data() {
            return {
                show : false
            }
        },
        methods : {
            hide() {
                this.show = false;
            }
        }
    }
</script>
```
:::



### dialog自定义内容
自定义填充dialog的主体内容

:::demo 
```html
<template>
    <div>
        <el-button @click="show=true;">
            打开弹窗
        </el-button>
        <ve-dialog :show.sync="show" title="我是自定义内容弹窗" width="500px" :showClose="true">
            <el-form :model="form">
                <el-form-item label="活动名称">
                    <el-col :span="12">
                        <el-input v-model="form.name"></el-input>
                    </el-col>
                </el-form-item>
                <el-form-item label="活动区域">
                    <el-col :span="12" 
                    <el-select v-model="form.region" placeholder="请选择活动区域" >
                        <el-option label="区域一" value="shanghai"></el-option>
                        <el-option label="区域二" value="beijing"></el-option>
                    </el-select>
                    </el-col>
                </el-form-item>
            </el-form>
            <span slot="footer">
                <el-button @click="hide">
                    取 消
                </el-button>
                <el-button type="primary">
                    确 定
                </el-button>
		    </span>
        </ve-dialog>    
    </div>
</template>

<script>
    export default {
        data() {
            return {
                show : false,
                form: {
                    name: '',
                    region: ''
                }
            }
        },
        methods : {
            hide() {
                this.show = false;
            }
        }
    }
</script>
```
:::

### 设置dialog
可自定义设置dialog的宽度、距顶部距离、标题及右上角关闭按钮展示与否

:::demo `width`设置弹框宽度；`top`设置弹框距顶部距离 `title`可自定义弹窗标题文案；右上角x显示与否，通过`:showClose="false"`设置， 默认`true`，显示关闭按钮。
```html
<template>
    <div>
        <el-button @click="show=true;">
            打开弹窗
        </el-button>
        <ve-dialog :show.sync="show" title="我是弹窗" width="500px" top="20%" :showClose="true">
            <div>
                我是内容123
            </div>
        </ve-dialog>    
    </div>
</template>

<script>
    export default {
        data() {
            return {
                show : false
            }
        },
        methods : {
            hide() {
                this.show = false;
            }
        }
    }
</script>
```
:::



### dialog关闭回调
弹窗关闭前的回调，多用于二次确认是否要关闭弹窗

:::demo `beforeClose`在点击关闭按钮或遮罩关闭弹窗时触发，若在footer具名slot添加了关闭弹窗的按钮，可在按钮点击回调函数加入before-close的相关逻辑。
```html
<template>
    <div>
        <el-button @click="show=true;">
            打开弹窗
        </el-button>
        <ve-dialog :show.sync="show" title="我是弹窗标题" :showClose="true" :beforeClose="handleClose">
            <div>
                我是弹窗内容
            </div>
            <span slot="footer">
                <el-button @click="handleClose">
                    取 消
                </el-button>
                <el-button type="primary">
                    确 定
                </el-button>
		</span>
        </ve-dialog>    
    </div>
</template>

<script>
    export default {
        data() {
            return {
                show : false
            }
        },
        methods : {
            handleClose () {
                this.$confirm('确认关闭该弹窗？').then(() => {
                    this.show = false;
                }).catch(()=> {});
            }
        }
    }
</script>
```
:::

### Attributes
| 参数      | 说明          | 类型      | 可选值                           | 默认值  |
|---------- |-------------- |---------- |--------------------------------  |-------- |
| show | 是否打开弹窗 | boolean | — | false |
| width | 弹窗宽度 | string | — | — |
| top | 距顶部距离 | string | — | — |
| title | 弹窗标题文案 | string | — | — |
| showClose | 是否展示关闭按钮 | boolean | — | true |
| beforeClose | 弹窗关闭前回调 | function(done)，done 用于关闭 Dialog | — | — |

### Slot

| Name | Description |
|------|--------|
| — | 描述 |
| footer | 弹窗底部按钮操作内容 |


