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
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | boolean | false | 组件式用法的显隐,使用 v-model 双向绑定;服务式调用无需关心 |
title | string | "" | 标题;为空时取 locale messagebox.title(默认「提示」) |
message | string | "" | 正文内容;服务函数的第一个参数 |
type | string:'info' | 'success' | 'warning' | 'error' | - | 类型图标,显示在标题前(options.type) |
boxType | string:'alert' | 'confirm' | 'prompt' | "confirm" | 弹窗形态:alert 仅确定按钮;confirm 确定+取消;prompt 额外带输入框;服务函数自动设置 |
confirmText | string | "" | 确定按钮文案;为空时取 locale messagebox.confirm(默认「确定」) |
cancelText | string | "" | 取消按钮文案;为空时取 locale messagebox.cancel(默认「取消」) |
maskClosable | boolean | true | 点击遮罩是否关闭(视为取消:showConfirm resolve false、showPrompt resolve null) |
placeholder | string | "" | prompt 输入框占位文本(showPrompt options.placeholder) |
defaultValue | string | "" | prompt 输入框默认值(showPrompt options.defaultValue) |
pattern | RegExp | - | prompt 输入校验正则(showPrompt options.pattern):不匹配时输入框红边 + 错误文案(locale messagebox.promptError),确定按钮禁用 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | boolean | 显隐变化时触发,配合 v-model 使用 |
confirm | string | 点击确定时触发;prompt 时载荷为输入值 |
cancel | void | 点击取消 / 遮罩 / Escape 时触发 |
close | void | 任何途径关闭时触发 |
closed | void | 关闭动画结束后触发;服务函数内部据此卸载 DOM |
Methods
| 名称 | 签名 | 说明 |
|---|---|---|
showAlert | showAlert(message: string, title?: string, options?: MessageBoxOptions): Promise<void> | 警告框:只有一个确定按钮,确定/遮罩/Escape 后 resolve |
showConfirm | showConfirm(message: string, title?: string, options?: MessageBoxOptions): Promise<boolean> | 确认框:确定 resolve true;取消/遮罩/Escape resolve false |
showPrompt | showPrompt(message: string, title?: string, options?: MessageBoxPromptOptions): Promise<string | null> | 输入框:确定 resolve 输入值;取消/遮罩/Escape resolve null;options.pattern 可校验输入 |
示例
showAlert 警告框
示例加载中…
<Button variant="primary" @click="showAlert('您的会员将于 7 天后到期,请及时续费以保留特权。', '到期提醒', { type: 'warning' })">会员到期提醒</Button>showConfirm 确认框
示例加载中…
<Button variant="danger" @click="showConfirm('确定删除该订单?删除后不可恢复。', '删除订单', { type: 'error', confirmText: '删除' }).then((ok) => ok && showToast('订单已删除'))">删除订单</Button>showPrompt 输入框(带校验)
示例加载中…
<Button variant="secondary" @click="showPrompt('请输入拒绝原因', '拒绝申请', { placeholder: '例如:资料不完整', defaultValue: '', pattern: /\S{2,}/ }).then((reason) => reason && showToast('已拒绝:' + reason))">拒绝申请</Button>跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 MessageBox 文档(含手机预览)。