跳到主要内容

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 ​

名称类型默认值说明
modelValuebooleanfalse显隐,使用 v-model 双向绑定
titlestring""标题;为空时显示「提示」
messagestring""正文内容
typestring:'info' | 'success' | 'warning' | 'error'-类型图标,显示在标题前
boxTypestring:'alert' | 'confirm' | 'prompt'"confirm"弹窗形态:alert 仅确定按钮;confirm 确定+取消;prompt 额外带输入框
confirmTextstring""确定按钮文案;为空时显示「确定」
cancelTextstring""取消按钮文案;为空时显示「取消」
maskClosablebooleantrue点击遮罩是否关闭(视为取消)
placeholderstring""prompt 输入框占位文本
defaultValuestring""prompt 输入框默认值;每次打开时重置为该值
patternRegExp(.uvue 端为正则源字符串)-prompt 输入校验:不匹配时输入框红边 + 错误文案,确定按钮禁用
zIndexnumber1002遮罩层层级

Events ​

名称载荷说明
update:modelValueboolean显隐变化时触发,配合 v-model 使用
confirmstring点击确定时触发;prompt 时载荷为输入值
cancelvoid点击取消 / 遮罩时触发
closevoid任何途径关闭时触发
closedvoid关闭后触发;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="请输入新名称" />