Skip to content

Dialog 对话框

在保留当前页面状态的情况下,告知用户并承载相关操作。

基础用法

Dialog 弹出一个对话框,适合需要定制性更大的场景。

自定义内容

Dialog 组件的内容可以是任意的,甚至可以是表格或表单,下面是自定义内容的示例。

居中布局

标题和底部可水平居中。

center 设置为 true 即可使标题和底部居中。 align-center 可以使对话框水平垂直居中。

✨ 独特功能:可拖拽与最小化

Fyoimiya UI 的 Dialog 支持类似窗口系统的操作体验。

设置 draggable 属性启用拖拽,minimizablemaximizable 启用最小化和最大化。

🔮 独特功能:毛玻璃与音效

打造沉浸式的 UI 体验。

设置 glass 开启毛玻璃效果,sound 开启打开/关闭音效。

Dialog 属性

属性名说明类型默认值
model-value / v-model是否显示 Dialogbooleanfalse
titleDialog 的标题,也可通过具名 slot (见下表)传入string
widthDialog 的宽度string / number50%
fullscreen是否为全屏 Dialogbooleanfalse
topDialog CSS 中的 margin-top 值string15vh
modal是否需要遮罩层booleantrue
modal-class遮罩层的自定义类名string
lock-scroll是否在 Dialog 出现时将 body 滚动锁定booleantrue
open-delayDialog 打开的延时时间,单位毫秒number0
close-delayDialog 关闭的延时时间,单位毫秒number0
close-on-click-modal是否可以通过点击 modal 关闭 Dialogbooleantrue
close-on-press-escape是否可以通过按下 ESC 关闭 Dialogbooleantrue
show-close是否显示关闭按钮booleantrue
before-close关闭前的回调,会暂停 Dialog 的关闭function(done)
draggable为 Dialog 启用可拖拽功能booleanfalse
center是否对头部和底部采用居中布局booleanfalse
align-center是否水平垂直对齐对话框booleanfalse
destroy-on-close关闭时销毁 Dialog 中的元素booleanfalse
glass✨ 是否开启毛玻璃效果booleanfalse
minimizable✨ 是否显示最小化按钮booleanfalse
maximizable✨ 是否显示最大化按钮booleanfalse
sound✨ 是否开启音效booleanfalse
append-to-bodyDialog 自身是否插入至 body 元素上。嵌套的 Dialog 必须指定该属性并赋值为 truebooleanfalse
z-indexDialog 的 z-indexnumber2000

Dialog 插槽

插槽名说明
defaultDialog 的内容
headerDialog 标题区的内容
footerDialog 按钮操作区的内容

Dialog 事件

事件名说明回调参数
openDialog 打开的回调
openedDialog 打开动画结束时的回调
closeDialog 关闭的回调
closedDialog 关闭动画结束时的回调
minimize✨ 最小化时的回调
maximize✨ 最大化时的回调isFull: boolean