跳到主要内容

Dialog 对话框 ​

WebH5

对话框。通过 v-model 控制显隐,Teleport 到 body 渲染;桌面居中弹层,移动端自动变为贴底全宽面板(适配安全区)。支持遮罩点击关闭、Escape 关闭与自定义标题/底部插槽。

何时使用 ​

需要用户确认或处理的关键操作:删除确认、表单弹窗、重要提示。

何时不使用 ​

轻量反馈用 Toast;复杂多步流程考虑抽屉或独立页面;移动端底部操作用 ActionSheet。

Props ​

名称类型默认值说明
modelValuebooleanfalse是否显示,使用 v-model 双向绑定:v-model="visible"
titlestring""标题文本;可用 title 插槽覆盖
widthstring"420px"面板宽度;移动端(<768px)自动全宽贴底,此值不生效
maskClosablebooleantrue点击遮罩是否关闭
showClosebooleantrue是否显示右上角 × 关闭按钮
confirmTextstring"确定(取 locale 文案 dialog.confirm)"确定按钮文案
cancelTextstring"取消(取 locale 文案 dialog.cancel)"取消按钮文案
showFooterbooleantrue是否显示底部按钮区;置 false 并配合 footer 插槽可完全自定义
beforeClose(done: () => void) => void-关闭前钩子:所有关闭途径(遮罩/×/Escape/取消/确定)都会先调用它,调用 done() 后才真正关闭;用于异步确认或表单校验。多弹层时 z-index 由内部递增管理

Events ​

名称载荷说明
update:modelValueboolean显隐变化时触发,配合 v-model 使用
confirmvoid点击确定按钮时触发,随后对话框关闭
cancelvoid点击取消按钮时触发,随后对话框关闭
closevoid任何途径关闭时触发(确定/取消/遮罩/×/Escape)

Slots ​

名称说明
default正文内容
title自定义标题区,覆盖 title prop
footer自定义底部区,覆盖默认的取消/确定按钮组

示例 ​

基础确认 ​

示例加载中…

监听确认/取消 ​

示例加载中…
示例加载中…

隐藏底部 + 长内容滚动 ​

示例加载中…

禁止遮罩关闭 ​

示例加载中…

自定义标题插槽 ​

示例加载中…

Playground ​

加载中…

跨端版本 ​

该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Dialog 文档(含手机预览)。