Skip to content

Dialogs(对话框)

v-dialog 组件提醒用户进行特定的任务。其中或许包含关键信息,或许让用户选择,或包含多个任务。但应谨慎使用对话框,因为它具有打断效果。

Dialog Entry

使用

在基本的例子里,我们使用了 activator 插槽来渲染打开对话框的按钮。当使用 activator 插槽时,请注意需要把 props 绑定至(使用 v-bind)用于激活对话框的按钮上。查看下面的例子获取更多激活对话框的方式。

API

组件描述
v-dialog主要组件
v-overlay扩展组件

Anatomy

建议在 v-dialog 内部使用的组件是:

Dialog Anatomy

元素 / 区域描述
1. 容器The dialog's content that animates from the activator
2. ActivatorThe element that activates the dialog

指南

v-dialog 组件用于通知用户特定任务,可能包含关键信息、需要决策或涉及多个任务。它们由 v-model 和/或 activator控制。

属性

v-dialog 组件扩展了 v-overlay 并可以访问它的所有属性。

v-model

你可以通过 v-model 的更新来激活对话框,既不需要 activator 插槽或者属性。在下面的例子中,对话框不会表现为从某个组件激活,只会单单地出现在屏幕中央。

对话框保持

保持的对话框不会因为点击对话框外部或者按 esc 键就会关闭。

过渡动画

您可以让对话框从顶部或底部渐显出现。

嵌套

对话框可以嵌套:可以从一个对话框打开另一个对话框。

溢出

若对话框内容溢出,将在对话框内显示滚动条。

Slots

v-dialog 组件有 2 个插槽,activatordefaultactivator 插槽用于指定将激活对话框的元素。default 插槽提供一个 isActive 引用,它与对话框的当前状态相关。

激活器 (Activator)

除了使用 activator 插槽外,我们也可以使用 activator 属性来激活对话框。可以通过把对话框组件放置于按钮组件内,然后把对话框的 activator 属性的值设为 "parent",就可以使用它的 parent (按钮)来激活对话框。

默认值

示例

以下是一系列示例,演示了 v-dialog 组件的更高级和实际使用。

可滚动

一个可滚动内容的对话框示例。

表单对话框

一个镶嵌了表单的对话框例子。

加载图标

我们可以通过 v-dialog 组件为 app 轻松创建自定义加载效果。

全屏对话框

由于屏幕空间有限,移动设备最好使用全屏对话框,而不是普通设备屏幕上的大对话框。

邀请对话框

此示例演示了一个用于邀请用户加入组的对话框。