项目正在快速迭代中,API 与视觉细节可能随版本调整,请勿用于生产环境。
仅桌面端保证样式

Msgbox 消息弹窗 ​

命令式弹窗三件套:alert(警告)/ confirm(确认)/ prompt(输入),Promise 化返回结果。适合删除确认、关键操作二次校验等流程性交互;纯展示类弹窗用 Dialog。

三种形态 ​

confirm 确认时 resolve、取消时 reject,用 try/catch 承接;prompt 的确认值带在 value 字段。脚本中通过导入的 EbMsgbox 调用(模板内联表达式也可直接用全局属性 $alert / $confirm / $prompt):

输入校验 ​

prompt 支持 inputPattern 正则与 inputValidator 函数两种校验,校验失败阻止确认并显示错误文案:

区分「取消」与「关闭」 ​

distinguishCancelAndClose 开启后,ESC / 关闭按钮返回 close,取消按钮返回 cancel,两者可分别处理:

HTML 内容与文案定制 ​

html: true 时 message 按 HTML 片段渲染(内容由调用方负责转义,警惕 XSS);confirmButtonText 自定义确认文案,center 居中、showIcon / showClose 控制图标与关闭钮:

prompt 预置输入与校验函数 ​

inputValue 预置输入框初值,inputValidator 返回错误文案即视为不通过,适合带业务规则的输入:

调用形式 ​

三种重载等价,参数可缺位:(message, title?, options?)、(message, options?),也可对象式整体传入 EbMsgbox({ message, title, showCancelButton: true, ... });模板内联可用全局属性 $msgbox / $alert / $confirm / $prompt。

Msgbox Options

参数说明类型默认值
message / title内容与标题string
type类型图标与配色success | warning | info | errorinfo
html以 HTML 片段渲染 message(内容由调用方负责转义)booleanfalse
showIcon / showClose显示类型图标 / 右上角关闭钮booleantrue
showCancelButton显示取消按钮(alert 默认无)booleanfalse
distinguishCancelAndClose区分取消与关闭动作booleanfalse
confirmButtonText / cancelButtonText按钮文案string确定 / 取消
confirmButtonClass确认按钮类型色(同 Button 的 type)stringprimary
confirmButtonLoading / cancelButtonLoading确认 / 取消按钮 loading(异步校验场景)booleanfalse
roundButton / buttonSize按钮圆角与尺寸boolean / stringfalse / default
center内容居中booleanfalse
closeOnClickModal / closeOnPressEscape点遮罩 / ESC 关闭booleantrue
inputType / inputValue / inputPlaceholderprompt 输入框类型 / 预置值 / 占位文案string
inputPattern输入正则校验RegExpnull
inputValidator输入校验函数,返回错误文案即视为不通过(value) => string | truenull
inputErrorMessage正则校验失败提示string
lockScroll弹窗期间锁定页面滚动booleanfalse

返回值

参数说明类型默认值
confirm确认按钮 → resolvePromise<{ action: string, value: string }>—
cancel取消按钮 / ESC → rejectPromise<{ action: string, value: string }>—
close开启 distinguishCancelAndClose 后,ESC / 关闭钮 → reject,action 为 closePromise<{ action: string, value: string }>—
prompt.value确认时携带输入值string