MessageBox 消息盒
uni-appH5微信小程序App
uni-app 跨端消息弹窗(对标 alert / confirm / prompt)。组件式用法通过 v-model 控制显隐,视觉与 Dialog 一致(遮罩 + 居中面板)。三种形态:alert 仅确定按钮;confirm 确定+取消;prompt 额外带输入框,可用 pattern 校验输入,不匹配时输入框红边 + 错误文案且确定按钮禁用。按钮/标题文案留空时回退默认中文文案(提示/确定/取消),显式 prop 永远优先。uni-app 端无进出场动画,closed 事件在 close 后立即触发;类型图标使用 base64 <image>(无法随 type 变色)。
何时使用
需要用户确认或输入的轻量交互:删除确认、驳回原因填写、重要提示。
何时不使用
复杂表单或自定义内容用 Dialog;纯结果反馈用 Toast/NoticeBar;底部多操作用 ActionSheet。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
9:41
MessageBox 消息盒 · uni-app H5 实时运行 新窗口打开
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | boolean | false | 显隐,使用 v-model 双向绑定 |
title | string | "" | 标题;为空时显示「提示」 |
message | string | "" | 正文内容 |
type | string:'info' | 'success' | 'warning' | 'error' | - | 类型图标,显示在标题前 |
boxType | string:'alert' | 'confirm' | 'prompt' | "confirm" | 弹窗形态:alert 仅确定按钮;confirm 确定+取消;prompt 额外带输入框 |
confirmText | string | "" | 确定按钮文案;为空时显示「确定」 |
cancelText | string | "" | 取消按钮文案;为空时显示「取消」 |
maskClosable | boolean | true | 点击遮罩是否关闭(视为取消) |
placeholder | string | "" | prompt 输入框占位文本 |
defaultValue | string | "" | prompt 输入框默认值;每次打开时重置为该值 |
pattern | RegExp(.uvue 端为正则源字符串) | - | prompt 输入校验:不匹配时输入框红边 + 错误文案,确定按钮禁用 |
zIndex | number | 1002 | 遮罩层层级 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | boolean | 显隐变化时触发,配合 v-model 使用 |
confirm | string | 点击确定时触发;prompt 时载荷为输入值 |
cancel | void | 点击取消 / 遮罩时触发 |
close | void | 任何途径关闭时触发 |
closed | void | 关闭后触发;uni-app 端无退场动画,紧随 close 触发 |
示例
确认框
vue
<Button variant="primary" @click="visible = true">confirm</Button>
<MessageBox v-model="visible" title="退出登录" message="确定要退出当前账号吗?" box-type="confirm" />提示框
vue
<Button variant="secondary" @click="visible2 = true">alert</Button>
<MessageBox v-model="visible2" title="提示" message="新版本已发布,重启后生效。" box-type="alert" type="success" />输入框
vue
<Button variant="ghost" @click="visible3 = true">prompt</Button>
<MessageBox v-model="visible3" title="重命名" box-type="prompt" placeholder="请输入新名称" />