## 基本用法 Dialog 弹出一个对话框,适合需要定制性更大的场景,如果只是弹出框,可以尝试 MessageBox 组件。 要使用 Dialog 组件,首先你需要设置`v-model`属性,它接收`Boolean`,当为`true`时显示 Dialog。 Dialog 分为两个部分:`body`和`footer`,`footer`需要具名为`footer`的`slot`。 `title`属性用于定义标题,它是可选的,默认值为空,下面是一个最简单的用例: 点击打开 Dialog
这是一段信息,这是一段信息,这是一段信息,这是一段信息,这是一段信息,这是一段信息,这是一段信息,这是一段信息 取 消 确 定
```html 点击打开 Dialog 这是一段信息,这是一段信息,这是一段信息,这是一段信息,这是一段信息,这是一段信息,这是一段信息,这是一段信息 取 消 确 定 ``` ## 设置尺寸 Dialog 组件提供四种尺寸:`tiny`, `small`, `large`, `full`。通过`size`属性来设置,下面是一个 tiny 的例子。 点击打开小尺寸 Dialog
这是一段内容 取 消 确 定
```html 点击打开小尺寸 Dialog 这是一段内容 取 消 确 定 ``` 下面是一个全屏幕 Dialog 的样例: 点击打开全屏幕 Dialog
```html 点击打开全屏幕 Dialog ``` ## 设置能否通过点击modal或按下esc关闭Dialog 在默认条件下,你可以通过 ESC 和点击背后的遮罩层关闭 Dialog,但是可以通过设置`close-on-click-modal`属性和`close-on-press-escape`属性来关闭这一功能,它们接收`Boolean`,默认均为`true`。 打开 Dialog,点击 modal 或按下 esc 关闭无法将其关闭
这是一段信息,这是一段信息,这是一段信息,这是一段信息,这是一段信息,这是一段信息,这是一段信息,这是一段信息
```html 打开 Dialog,点击 modal 或按下 esc 关闭无法将其关闭 这是一段信息,这是一段信息,这是一段信息,这是一段信息,这是一段信息,这是一段信息,这是一段信息,这是一段信息 ``` ## 使用 Dialog 方法打开 使用`v-model`确实是一个不错的做法,为了一些特殊需求,我们暴露了实例`open`和`close`方法,你可以不用显式改变`v-modal`的值了: 使用Dialog方法
这是一段信息,这是一段信息,这是一段信息,这是一段信息,这是一段信息,这是一段信息,这是一段信息,这是一段信息
```html ``` ## 自定义内容 Dialog 组件的正文标题可以是任意的,甚至可以是表格或表单,下面是应用了 Element Table 和 Form 组件的两个样例,除此以外,它们并没有什么特殊之处: 打开嵌套表格的 Dialog
打开嵌套表单的 Dialog
取 消 确 定
```html 打开嵌套表格的 Dialog 打开嵌套表单的 Dialog 取 消 确 定 ``` ## Attributes | 参数 | 说明 | 类型 | 可选值 | 默认值 | |---------- |-------------- |---------- |-------------------------------- |-------- | | title | Dialog 的标题 | string | | | | size | Dialog 的大小 | string | 'tiny', 'small', 'large', 'full' | 'small' | | modal | 是否需要遮罩层 | boolean | | true | | customClass | Dialog 的自定义类名 | string | | | | closeOnClickModal | 是否可以通过点击 modal 关闭 Dialog | boolean | | true | | closeOnPressEscape | 是否可以通过按下 ESC 关闭 Dialog | boolean | | true | ## Slot | name | 说明 | |------|--------| | - | Dialog 的内容 | | footer | Dialog 按钮操作区的内容 | ## 方法 每个`el-dialog`实例都暴露了如下方法,用于在不显式改变`v-model`值的情况下打开 / 关闭实例: | 方法名 | 说明 | |------|--------| | open | 打开当前实例 | | close | 关闭当前实例 |