Skip to content

ModalBox 确认弹窗

以函数方式快速弹出一个带图标的确认/提示弹窗。适合在交互中进行二次确认或展示重要信息。

基础用法

通过全局方法 $modalBox 打开一个确认弹窗。

图标类型

提供四种内置图标与主题:infosuccesswarningerror

自定义内容(VNode)

content 支持字符串或 VNode,可灵活渲染复杂内容。

底部按钮

可通过 confirmButtonTextcancelButtonText 修改按钮文案,或隐藏取消按钮。

异步确认

beforeChange 返回 Promise 时,确认按钮会进入加载态,Promise 结束后自动关闭。

遮罩行为

透传 maskmaskClose 给遮罩。默认点击遮罩会关闭;设置 :maskClose="true" 将禁止点击遮罩关闭。

方法

方法名参数说明
$modalBox(options)打开一个确认弹窗

提示:支持直接传入字符串作为内容(等价于 { content: '...' })。

选项

选项名类型默认值说明
titlestring''标题文本
contentstring | VNode''弹窗内容,支持传入 VNode(如 h('div', ...)
iconstringwarning图标与主题:info/success/warning/error
footerbooleantrue是否显示底部区域
cancelButtonTextstring取消取消按钮文本
cancelButtonShowbooleantrue是否显示取消按钮
confirmButtonTextstring确定确认按钮文本
confirmButtonShowbooleantrue是否显示确认按钮
confirmLoadingbooleanfalse外部受控的确认按钮加载态(与内置加载合并显示)
beforeChange() => Promise-点击确认时触发;返回 Promise,处理中显示加载,结束后自动关闭
maskbooleantrue是否显示遮罩(作为属性透传到内部 ue-mask
maskClosebooleanfalse是否禁止点击遮罩关闭。默认允许点击遮罩关闭;设为 true 不响应遮罩点击

安装与调用

全量引入组件库时会自动注册全局方法 $modalBox,可直接在组件内调用。

按需引入时也可单独安装:

ts
import { createApp } from "vue"
import { UeModalBox } from "flori-ui-vue3"

const app = createApp(App)
app.use(UeModalBox)