Dialogs(对话框)
v-dialog
组件提醒用户进行特定的任务。其中或许包含关键信息,或许让用户选择,或包含多个任务。但应谨慎使用对话框,因为它具有打断效果。
使用
在基本的例子里,我们使用了 activator 插槽来渲染打开对话框的按钮。当使用 activator 插槽时,请注意需要把 props 绑定至(使用 v-bind
)用于激活对话框的按钮上。查看下面的例子获取更多激活对话框的方式。
API
组件 | 描述 |
---|---|
v-dialog | 主要组件 |
v-overlay | 扩展组件 |
Anatomy
建议在 v-dialog
内部使用的组件是:
元素 / 区域 | 描述 |
---|---|
1. 容器 | The dialog's content that animates from the activator |
2. Activator | The element that activates the dialog |
指南
v-dialog
组件用于通知用户特定任务,可能包含关键信息、需要决策或涉及多个任务。它们由 v-model 和/或 activator控制。
属性
v-dialog
组件扩展了 v-overlay 并可以访问它的所有属性。
v-model
你可以通过 v-model 的更新来激活对话框,既不需要 activator 插槽或者属性。在下面的例子中,对话框不会表现为从某个组件激活,只会单单地出现在屏幕中央。
对话框保持
保持的对话框不会因为点击对话框外部或者按 esc 键就会关闭。
过渡动画
您可以让对话框从顶部或底部渐显出现。
嵌套
对话框可以嵌套:可以从一个对话框打开另一个对话框。
溢出
若对话框内容溢出,将在对话框内显示滚动条。
Slots
v-dialog
组件有 2 个插槽,activator 和 default。activator 插槽用于指定将激活对话框的元素。default 插槽提供一个 isActive 引用,它与对话框的当前状态相关。
激活器 (Activator)
除了使用 activator 插槽外,我们也可以使用 activator 属性来激活对话框。可以通过把对话框组件放置于按钮组件内,然后把对话框的 activator 属性的值设为 "parent",就可以使用它的 parent (按钮)来激活对话框。
默认值
示例
以下是一系列示例,演示了 v-dialog
组件的更高级和实际使用。
可滚动
一个可滚动内容的对话框示例。
表单对话框
一个镶嵌了表单的对话框例子。
加载图标
我们可以通过 v-dialog
组件为 app 轻松创建自定义加载效果。
全屏对话框
由于屏幕空间有限,移动设备最好使用全屏对话框,而不是普通设备屏幕上的大对话框。
邀请对话框
此示例演示了一个用于邀请用户加入组的对话框。