对话框 Dialog

反馈 · 可交互组件

确认和取消对话框

按需导入wbbb-ui/components/dialog

基础用法

<script setup lang="ts">
import { showDialog } from 'wbbb-ui/services/dialog'

function open() { showDialog('保存成功') }
</script>

<template><button @click="open">打开对话框</button></template>

真实移动端预览新窗口打开 ↗

状态与交互

以下状态均可在右侧的真实 Playground 中操作与验收。

默认按压选中禁用

服务型组件需在应用根部挂载 <wbbb-overlay-host />；未挂载时会回退到 uni-app 原生能力。

API 参考

属性（Props）

属性	说明	类型	默认值	必填
`cancelText`	覆盖取消操作的文案。	`string`	`由 locale 决定`	否
`confirmText`	覆盖确认操作的文案。	`string`	`由 locale 决定`	否
`content`	提供组件的主要文本内容。	`string`	`''`	否
`locale`	覆盖组件内置文案使用的语言。	`WbbbLocaleInput`	`—`	否
`modelValue`	提供 v-model 使用的当前值。	`boolean`	`false`	否
`showCancel`	控制是否显示取消操作。	`boolean`	`true`	否
`title`	设置组件标题文字。	`string`	`''`	否

事件（Events）

update:modelValue
cancel
close
confirm

插槽（Slots）

default

双向绑定

支持 v-model（modelValue）。

平台说明

构建验证：H5、App Vue、微信小程序、支付宝小程序与抖音小程序。

运行时差异：H5 支持键盘焦点与减弱动效；小程序端使用等价触控交互。上传、日期选择和服务弹层应在目标端再次验收。

使用提示：服务调用可独立于全量安装使用，并由 Overlay Host 管理队列与视觉层级。

对话框 Dialog ​

基础用法 ​

状态与交互 ​

API 参考 ​