Dialog 对话框
需要用户处理事务,又不希望跳转页面以致打断工作流程时,可以使用 Dialog 在当前页面正中打开一个浮层,承载相应的操作。
基础用法
居中对话框
设置 align-center 为 true 使对话框水平垂直居中。
API
Dialog props
属性名 | 说明 | 类型 | 默认值 |
---|---|---|---|
open(v-model) | 对话框是否可见 | boolean | false |
width | 对话框的宽度 | string/ number | 50% |
top | dialog CSS 中的 margin-top 值,默认为 15vh | string | — |
alignCenter | 是否水平垂直对齐对话框 | boolean | false |
modal | 是否需要遮罩层 | boolean | true |
closeOnClickModal | 点击蒙层是否可以关闭 | boolean | false |
showClose | 是否显示关闭按钮 | boolean | true |
title | 弹窗标题 | string | — |
zIndex | 和原生的 CSS 的 z-index 相同,改变 z 轴的顺序 | number | — |
overlayClass | 遮罩的自定义类名 | string | — |
lockScroll | 否在 Dialog 出现时将 body 滚动锁定 | boolean | true |
appendTo | 默认给弹窗挂到哪个地方:了解teleport内置组件属性 | string | body |
beforeClose | 关闭前的回调,会暂停 Dialog 的关闭. 回调函数内执行 done 参数方法的时候才是真正关闭对话框的时候 | Function | — |
Dialog Events
属性名 | 说明 | 类型 |
---|---|---|
close | 弹窗关闭时事件 | Function() => void |
Slots
插槽名 | 说明 |
---|---|
- | Dialog 的内容 |
header | 对话框标题的内容 |
footer | Dialog 按钮操作区的内容 |