---
弹出对话框，常用于消息提示、消息确认等，支持函数调用。
:::tip 提示
全局调用方案见 wot-starter，支持在路由导航守卫和网络请求拦截器等场景使用的可全局调用的反馈组件。
:::
alert 弹框只有确定按钮，用于强提醒。
<wd-message-box></wd-message-box>
<wd-button @click="alert">alert</wd-button>
import { useMessage } from '@/uni_modules/wot-design-uni'
const message = useMessage()
function alert() {
message.alert('操作成功')
}
显示标题的 alert 弹框。
<wd-message-box />
<wd-button @click="alert">alert</wd-button>
import { useMessage } from '@/uni_modules/wot-design-uni'
const message = useMessage()
function alert() {
message.alert({
msg: '提示文案',
title: '标题'
})
}
如果内容文案过长，弹框高度不再增加，而是展示滚动条。
<wd-message-box />
<wd-button @click="alert">alert</wd-button>
import { useMessage } from '@/uni_modules/wot-design-uni'
const message = useMessage()
function alert() {
message.alert({
msg: '以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文字是示意以上文',
title: '标题'
})
}
用于提示用户操作。
<wd-message-box />
<wd-button @click="confirm">confirm</wd-button>
import { useMessage } from '@/uni_modules/wot-design-uni'
const message = useMessage()
function confirm() {
message
.confirm({
msg: '提示文案',
title: '标题'
})
.then(() => {
console.log('点击了确定按钮')
})
.catch(() => {
console.log('点击了取消按钮')
})
}
prompt 会展示一个输入框，并可以进行输入校验。
<wd-message-box />
<wd-button @click="prompt">prompt</wd-button>
import { useMessage } from '@/uni_modules/wot-design-uni'
const message = useMessage()
function prompt() {
message
.prompt({
title: '请输入邮箱',
inputValue: value1.value,
inputPattern: /.+@.+\..+/i
})
.then((resp) => {
console.log(resp)
})
.catch((error) => {
console.log(error)
})
}
如果提供的弹框内容不满足需求，可以使用插槽自定义弹框内容。可以通过指定唯一标识selector的方式，在一个页面中使用多个MessageBox,useMessage(selector)会返回一个指定了selector的组件实例。
<wd-message-box selector="wd-message-box-slot">
<wd-rate custom-class="custom-rate-class" v-model="rate" />
</wd-message-box>
<wd-button @click="withSlot">custom</wd-button>
import { useMessage } from '@/uni_modules/wot-design-uni'
const rate = ref<number>(1)
const message = useMessage('wd-message-box-slot')
function withSlot() {
message
.confirm({
title: '评分'
})
.then(() => {
message.alert(`你的评分为：${rate.value}分`)
})
.catch((error) => {
console.log(error)
})
}
:deep(.custom-rate-class) {
display: block;
height: 22px;
}
设置 beforeConfirm 函数，在用户选择图片点击确认后，会执行 beforeConfirm 函数，接收 { resolve }，开发者可以在确认前进行处理，并通过 resolve 函数告知组件是否确定通过，resolve 接受 1 个 boolean 值，resolve(true) 表示选项通过，resolve(false) 表示选项不通过，不通过时不会完成确认操作。
<wd-toast />
<wd-message-box />
<wd-button @click="beforeConfirm">beforeConfirm</wd-button>
import { useMessage, useToast } from '@/uni_modules/wot-design-uni'
const message = useMessage()
const toast = useToast()
function beforeConfirm() {
message
.confirm({
msg: '是否删除',
title: '提示',
beforeConfirm: ({ resolve }) => {
toast.loading('删除中...')
setTimeout(() => {
toast.close()
resolve(true)
toast.success('删除成功')
}, 2000)
}
})
.then(() => {})
.catch((error) => {
console.log(error)
})
}
可以通过按钮属性 cancel-button-props 和 confirm-button-props 自定义操作按钮的样式，具体参考 Button Attributes。
<wd-message-box></wd-message-box>
<wd-button @click="withButtonProps">自定义按钮</wd-button>
function withButtonProps() {
message
.confirm({
msg: '自定义按钮样式',
title: '提示',
cancelButtonProps: {
type: 'error',
customClass: 'custom-shadow'
},
confirmButtonProps: {
type: 'success',
customClass: 'custom-shadow'
}
})
.then(() => {})
.catch((error) => {
console.log(error)
})
}
:deep() {
.wd-message-box {
.custom-shadow {
box-shadow: 0 3px 1px -2px rgb(0 0 0 / 20%), 0 2px 2px 0 rgb(0 0 0 / 14%), 0 1px 5px 0 rgb(0 0 0 / 12%);
}
}
}
弹框在点击确定和取消按钮时，会返回一个 promise 对象，用 then 接收“确定”按钮事件，用 catch 接收“取消”按钮事件。传入的 action 值为:'confirm'、'cancel'、'modal'。
MessageBox.show(msg)在调用时直接传入字符串，MessageBox.show(options) 在调用时，需传入 options 参数。alert、confirm 和 prompt 都支持快捷调用：
MessageBox.show(msg)
MessageBox.show(options)
MessageBox.alert(options)
MessageBox.confirm(options)
MessageBox.prompt(options)
| 参数 | 说明 | 类型 | 可选值 | 默认值 | 最低版本 |
|---|
| title | 标题 | string | - | - | - |
| msg | 消息文案 | string | - | - | - |
| type | 弹框类型 | string | alert / confirm / prompt | alert | - |
| closeOnClickModal | 是否支持点击蒙层进行关闭，点击蒙层回调传入的 action 为'modal' | boolean | - | true | - |
| inputType | 当 type 为 prompt 时，输入框类型 | string | - | text | - |
| inputValue | 当 type 为 prompt 时，输入框初始值 | string / number | - | - | - |
| inputPlaceholder | 当 type 为 prompt 时，输入框 placeholder | string | - | 请输入内容 | - |
| inputPattern | 当 type 为 prompt 时，输入框正则校验，点击确定按钮时进行校验 | regex | - | - | - |
| inputValidate | 当 type 为 prompt 时，输入框校验函数，点击确定按钮时进行校验 | function | - | - | - |
| inputError | 当 type 为 prompt 时，输入框检验不通过时的错误提示文案 | string | - | 输入的数据不合法 | - |
| confirmButtonText | 确定按钮文案 | string | - | 确定 | - |
| cancelButtonText | 取消按钮文案 | string | - | 取消 | - |
| zIndex | 弹窗层级 | number | - | 99 | - |
| lazyRender | 弹层内容懒渲染，触发展示时才渲染内容 | boolean | - | true | - |
| cancel-button-props | 取消按钮的属性，具体参考 Button Attributes | object | - | - | 1.5.0 |
| confirm-button-props | 确定按钮的属性，具体参考 Button Attributes | object | - | - | 1.5.0 |
| 参数 | 说明 | 类型 | 可选值 | 默认值 | 最低版本 |
|---|
| selector | 指定唯一标识 | string | - | - | - |
| root-portal | 是否从页面中脱离出来，用于解决各种 fixed 失效问题 | boolean | - | false | 1.11.0 |
| 类名 | 说明 | 最低版本 |
|---|
| custom-class | 根节点样式 | - |