跳到主要内容

MessageBox 消息盒 ​

WebH5

服务式弹窗(对标 alert / confirm / prompt)。通过 showAlert / showConfirm / showPrompt 一行调起,视觉与 Dialog 一致(遮罩 + 居中面板 + scale 入场),关闭动画结束后自动卸载 DOM。三个函数都返回 Promise:showConfirm 确定 resolve true、取消/遮罩/Escape resolve false(是 resolve 不是 reject);showPrompt 确定 resolve 输入值、取消 resolve null;showAlert 仅确定按钮。按钮文案默认走 locale(messagebox.*),options 显式传入优先。也可作为组件通过 v-model 使用。

何时使用 ​

需要用户确认或输入的轻量交互:删除确认、驳回原因填写、重要提示;想用一行代码 await 结果而不维护 visible 状态时。

何时不使用 ​

复杂表单或自定义内容用 Dialog;纯结果反馈用 Toast/Notification;移动端底部多操作用 ActionSheet。

Props ​

名称类型默认值说明
modelValuebooleanfalse组件式用法的显隐,使用 v-model 双向绑定;服务式调用无需关心
titlestring""标题;为空时取 locale messagebox.title(默认「提示」)
messagestring""正文内容;服务函数的第一个参数
typestring:'info' | 'success' | 'warning' | 'error'-类型图标,显示在标题前(options.type)
boxTypestring:'alert' | 'confirm' | 'prompt'"confirm"弹窗形态:alert 仅确定按钮;confirm 确定+取消;prompt 额外带输入框;服务函数自动设置
confirmTextstring""确定按钮文案;为空时取 locale messagebox.confirm(默认「确定」)
cancelTextstring""取消按钮文案;为空时取 locale messagebox.cancel(默认「取消」)
maskClosablebooleantrue点击遮罩是否关闭(视为取消:showConfirm resolve false、showPrompt resolve null)
placeholderstring""prompt 输入框占位文本(showPrompt options.placeholder)
defaultValuestring""prompt 输入框默认值(showPrompt options.defaultValue)
patternRegExp-prompt 输入校验正则(showPrompt options.pattern):不匹配时输入框红边 + 错误文案(locale messagebox.promptError),确定按钮禁用

Events ​

名称载荷说明
update:modelValueboolean显隐变化时触发,配合 v-model 使用
confirmstring点击确定时触发;prompt 时载荷为输入值
cancelvoid点击取消 / 遮罩 / Escape 时触发
closevoid任何途径关闭时触发
closedvoid关闭动画结束后触发;服务函数内部据此卸载 DOM

Methods ​

名称签名说明
showAlertshowAlert(message: string, title?: string, options?: MessageBoxOptions): Promise<void>警告框:只有一个确定按钮,确定/遮罩/Escape 后 resolve
showConfirmshowConfirm(message: string, title?: string, options?: MessageBoxOptions): Promise<boolean>确认框:确定 resolve true;取消/遮罩/Escape resolve false
showPromptshowPrompt(message: string, title?: string, options?: MessageBoxPromptOptions): Promise<string | null>输入框:确定 resolve 输入值;取消/遮罩/Escape resolve null;options.pattern 可校验输入

示例 ​

showAlert 警告框 ​

示例加载中…

showConfirm 确认框 ​

示例加载中…

showPrompt 输入框(带校验) ​

示例加载中…

跨端版本 ​

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