Dialog 对话框
WebH5
对话框。通过 v-model 控制显隐,Teleport 到 body 渲染;桌面居中弹层,移动端自动变为贴底全宽面板(适配安全区)。支持遮罩点击关闭、Escape 关闭与自定义标题/底部插槽。
何时使用
需要用户确认或处理的关键操作:删除确认、表单弹窗、重要提示。
何时不使用
轻量反馈用 Toast;复杂多步流程考虑抽屉或独立页面;移动端底部操作用 ActionSheet。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | boolean | false | 是否显示,使用 v-model 双向绑定:v-model="visible" |
title | string | "" | 标题文本;可用 title 插槽覆盖 |
width | string | "420px" | 面板宽度;移动端(<768px)自动全宽贴底,此值不生效 |
maskClosable | boolean | true | 点击遮罩是否关闭 |
showClose | boolean | true | 是否显示右上角 × 关闭按钮 |
confirmText | string | "确定(取 locale 文案 dialog.confirm)" | 确定按钮文案 |
cancelText | string | "取消(取 locale 文案 dialog.cancel)" | 取消按钮文案 |
showFooter | boolean | true | 是否显示底部按钮区;置 false 并配合 footer 插槽可完全自定义 |
beforeClose | (done: () => void) => void | - | 关闭前钩子:所有关闭途径(遮罩/×/Escape/取消/确定)都会先调用它,调用 done() 后才真正关闭;用于异步确认或表单校验。多弹层时 z-index 由内部递增管理 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | boolean | 显隐变化时触发,配合 v-model 使用 |
confirm | void | 点击确定按钮时触发,随后对话框关闭 |
cancel | void | 点击取消按钮时触发,随后对话框关闭 |
close | void | 任何途径关闭时触发(确定/取消/遮罩/×/Escape) |
Slots
| 名称 | 说明 |
|---|---|
default | 正文内容 |
title | 自定义标题区,覆盖 title prop |
footer | 自定义底部区,覆盖默认的取消/确定按钮组 |
示例
基础确认
示例加载中…
监听确认/取消
示例加载中…
自定义 Footer
示例加载中…
隐藏底部 + 长内容滚动
示例加载中…
禁止遮罩关闭
示例加载中…
自定义标题插槽
示例加载中…
Playground
加载中…
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Dialog 文档(含手机预览)。