Dialog 对话框
优质
小牛编辑
128浏览
2023-12-01
在保留当前页面状态的情况下,告知用户并承载相关操作。
基本用法
Dialog 弹出一个对话框,适合需要定制性更大的场景。
visible
接受一个布尔变量,用于控制对话框的打开与关闭。
<div class="box-card" #card> <p el-row>点击按钮显示提示</p> <el-button (click)="card.toggle = true">扬州</el-button> <el-dialog [title]="'扬州'" [(visible)]="card.toggle"> <span>一个平均寿命很高的城市。</span> </el-dialog> <el-button (click)="card.toggle2 = true">夏威夷</el-button> <el-dialog [title]="'夏威夷'" [(visible)]="card.toggle2"> <span>我选择在夏威夷演讲。</span> </el-dialog> </div>
自定义内容
Dialog 组件的内容可以是任意的,甚至可以是表格或表单。
你可以通过ng-template
插入 html 片段甚至是组件来构建自定义的对话框。
<div class="box-card" #card> <el-button (click)="card.toggle = true">自定义标题</el-button> <el-dialog [title]="'扬州'" [(visible)]="card.toggle"> <ng-template #title> <span class="el-icon-warning"></span> <span>自定义的标题</span> </ng-template> <span>一个平均寿命很高的城市。</span> </el-dialog> <el-button (click)="card.toggle2 = true">自定义尾部</el-button> <el-dialog [(visible)]="card.toggle2"> <ng-template #title> <span>朗诵</span> </ng-template> <span>这篇葛底斯堡演讲朗诵的很好。</span> <ng-template #footer> <el-button (click)="card.toggle2 = false">是的</el-button> </ng-template> </el-dialog> </div>
回调函数
回调函数能够帮助你更细腻的定义何时关闭对话框。
你可以通过ng-template
插入 html 片段甚至是组件来构建自定义的对话框。
<div class="box-card" #card> <el-button (click)="card.toggle = true">回调函数</el-button> <el-dialog [title]="'扬州'" [(visible)]="card.toggle" [before-close]="handle"> <span>一个平均寿命很高的城市。</span> </el-dialog> </div> <script type="text"> // in Component: handle(done: Function): void { alert('一段同步或异步的任务') done() } </script>
居中显示
居中属性不会影响内容。
<div class="box-card" #card> <el-button (click)="card.toggle = true">居中显示</el-button> <el-dialog [title]="'一位扬州的长者'" [(visible)]="card.toggle" [center]="true"> <span>他为我们朗诵了葛底斯堡演讲。</span> </el-dialog> </div>
Dialog Attributes
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
visible | 是否显示 Dialog,双向绑定的值,亦可以通过 (visibleChange) 单独获取事件推送 | boolean | ||
title | Dialog 的标题,也可通过具名 ng-template 传入 | string | ng-template | ||
footer | Dialog 按钮操作区的尾部内容 | ng-template | ||
width | Dialog 的宽度 | string | ||
top | Dialog CSS 中的 top 值 | string | 15% | |
lock-scroll | 是否在 Dialog 出现时将 body 滚动锁定 | boolean | 1 | |
center | 居中显示(不包括内容) | boolean | ||
custom-class | Dialog 的自定义类名 | string | ||
close-on-click-modal | 是否可以通过点击 modal 关闭 Dialog | boolean | 1 | |
close-on-press-escape | 是否可以通过按下 ESC 关闭 Dialog | boolean | 1 | |
show-close | 是否显示关闭按钮 | boolean | 1 | |
before-close | 关闭前的回调,会暂停 Dialog 的关闭,参数用于关闭 Dialog | function |