在保留当前页面状态的情况下,告知用户并承载相关操作。
¶基本用法
Dialog 弹出一个对话框,适合需要定制性更大的场景。
<!DOCTYPE html>
<html>
<head>
<link rel="stylesheet" href="css/index.css">
<script src="js/vue.js"></script>
<!-- <script src="js/vue-router.js"></script> -->
<script src="js/index.js"></script>
<meta charset="utf-8">
<title></title>
</head>
<body>
<div id="info">
<el-button type="text" @click="dialog = true">点击打开 Dialog</el-button>
<el-dialog title="标题" :visible.sync="dialog" width="30%" :before-close="handleClose">
<span>这是一段信息</span>
<span slot="footer" class="dialog-footer">
<el-button @click="cancel">取 消</el-button>
<el-button type="primary" @click="confirm">确 定</el-button>
</span>
</el-dialog>
</div>
<script>
var k = new Vue({
el: '#info',
data: {
//开启对话框的变量
dialog: true
},
methods: {
handleClose(){
this.dialog = false;
console.log('关闭事件');
},
cancel(){
this.dialog = false;
console.log('取消事件');
},
confirm(){
this.dialog = false;
console.log('确定事件');
}
}
})
</script>
</body>
</html>
Attributes
参数 |
说明 |
类型 |
可选值 |
默认值 |
---|
visible |
是否显示 Dialog,支持 .sync 修饰符 |
boolean |
— |
false |
title |
Dialog 的标题,也可通过具名 slot (见下表)传入 |
string |
— |
— |
width |
Dialog 的宽度 |
string |
— |
50% |
fullscreen |
是否为全屏 Dialog |
boolean |
— |
false |
top |
Dialog CSS 中的 margin-top 值 |
string |
— |
15vh |
modal |
是否需要遮罩层 |
boolean |
— |
true |
modal-append-to-body |
遮罩层是否插入至 body 元素上,若为 false,则遮罩层会插入至 Dialog 的父元素上 |
boolean |
— |
true |
append-to-body |
Dialog 自身是否插入至 body 元素上。嵌套的 Dialog 必须指定该属性并赋值为 true |
boolean |
— |
false |
lock-scroll |
是否在 Dialog 出现时将 body 滚动锁定 |
boolean |
— |
true |
custom-class |
Dialog 的自定义类名 |
string |
— |
— |
close-on-click-modal |
是否可以通过点击 modal 关闭 Dialog |
boolean |
— |
true |
close-on-press-escape |
是否可以通过按下 ESC 关闭 Dialog |
boolean |
— |
true |
show-close |
是否显示关闭按钮 |
boolean |
— |
true |
before-close |
关闭前的回调,会暂停 Dialog 的关闭 |
function(done),done 用于关闭 Dialog |
— |
— |
center |
是否对头部和底部采用居中布局 |
boolean |
— |
false |
destroy-on-close |
关闭时销毁 Dialog 中的元素 |
boolean |
— |
false |
¶Slot
name |
说明 |
---|
— |
Dialog 的内容 |
title |
Dialog 标题区的内容 |
footer |
Dialog 按钮操作区的内容 |
¶Events
事件名称 |
说明 |
回调参数 |
---|
open |
Dialog 打开的回调 |
— |
opened |
Dialog 打开动画结束时的回调 |
— |
close |
Dialog 关闭的回调 |
— |
closed |
Dialog 关闭动画结束时的回调 |
— |