EMessageBox 消息弹窗
示例与代码
消息弹窗
属性
alignCenterbool是否采用居中布局或居中文字。
继承 Provider,默认 trueautofocusbool组件显示时自动聚焦;受控件可用状态及弹层生命周期影响。
truebackgroundColorcolor背景颜色。
动态绑定beforeClosevar关闭前回调;弹窗通过 done(cancel) 完成异步判断。
function(action, instance, done) { done() }borderColorcolor边框颜色。
动态绑定buttonSizeint操作按钮尺寸。
EStyle.SmallEStyle.MediumEStyle.Large
EStyle.Mediumcallbackvar消息框结果回调,接收操作类型和输入值。
nullcancelButtonLoadingbool取消或确认按钮是否显示加载状态。
falsecancelButtonLoadingIconint组件使用的图标。
EIcons.*
0(无图标)
0cancelStyleTypeint语义配色风格。
EStyle.DefaultEStyle.PrimaryEStyle.SuccessEStyle.InfoEStyle.WarningEStyle.Danger
EStyle.DefaultcancelTextstring取消按钮文字。
随当前语言变化centerbool是否采用居中布局或居中文字。
falsecloseDelayint等待、节流或自动关闭时间,单位为毫秒;0 表示不延迟或不启用定时关闭。
0closeIconint组件使用的图标。
EIcons.*
0(无图标)
EIcons.XMARKcloseOnClickOutsidebool点击弹层外部时关闭。
truecloseOnEscapebool是否允许按 Escape 关闭。
trueclosePolicyenum弹层自动关闭的触发条件,可组合多个条件。
Popup.*(可用 | 组合)
NoAutoClose
CloseOnPressOutside
CloseOnPressOutsideParent
CloseOnReleaseOutside
CloseOnReleaseOutsideParent
CloseOnEscape
动态绑定confirmButtonLoadingbool取消或确认按钮是否显示加载状态。
falseconfirmButtonLoadingIconint组件使用的图标。
EIcons.*
0(无图标)
0confirmStyleTypeint语义配色风格。
EStyle.DefaultEStyle.PrimaryEStyle.SuccessEStyle.InfoEStyle.WarningEStyle.Danger
EStyle.PrimaryconfirmTextstring确认按钮文字。
随当前语言变化contentalias内容插槽;直接在组件内部声明 QML 子对象。
别名:dialogContent.datacontentComponentComponent自定义主体内容的 Component 插槽;null 使用默认内容。 委托上下文见本页示例。
nulldangerouslyUseHTMLStringbool按富文本解释内容;仅应对可信内容启用。
falsedestroyOnClosebool关闭后销毁通过 Component 加载的内容。
falsedialogRadiusreal圆角半径,单位为像素。
8distinguishCancelAndClosebool区分取消按钮与其他关闭方式产生的结果。
falsedraggablebool是否支持拖动;具体拖动对象由当前组件决定。
继承 Provider,默认 falseenabledbool是否允许交互;false 时控件禁用。
trueenterDurationint动画或显示持续时间,单位为毫秒;组件的绑定表达式给出实际用途。
220exitDurationint动画或显示持续时间,单位为毫秒;组件的绑定表达式给出实际用途。
180focusbool是否请求弹层焦点。
autofocusfullscreenbool是否使用全屏显示或全窗口覆盖。
falseheightreal组件尺寸,单位为像素;可绑定父布局尺寸。
fullscreen && Overlay.overlay ? Overlay.overlay.height : implicitHeighticonSourceint组件使用的图标。
EIcons.*
0(无图标)
0inputErrorMessagestring消息框输入无效时的提示。
""inputPatternvar消息框输入的正则校验规则。
nullinputPlaceholderstring空值时显示的占位文字。
""inputTypestring消息框中的输入类型。
"text" / "textarea""password" / "number""email" / "tel""url"
"text"inputValidatorvar自定义消息框输入校验函数,可返回布尔值或错误文字。
nullinputValuestring消息框输入的当前值。
""modalbool使用模态弹层,阻止对下层内容的交互。
truemodalOverlayColorcolor模态或非模态遮罩颜色。
动态绑定modalPenetrablebool是否允许输入穿透非模态遮罩。
falsemodelessOverlayColorcolor模态或非模态遮罩颜色。
动态绑定openDelayint等待、节流或自动关闭时间,单位为毫秒;0 表示不延迟或不启用定时关闭。
0overflowbool是否允许对话框拖动超出窗口范围。
继承 Provider,默认 falseroundButtonbool采用圆角胶囊按钮样式。
falseshowCancelButtonbool是否显示取消按钮。
trueshowClosebool是否显示关闭或删除按钮。
trueshowConfirmButtonbool是否显示确认按钮。
trueshowHeaderbool是否显示头部区域。
trueshowInputbool显示数值输入或消息框输入区域。
falsestyleTypeint语义配色风格。
EStyle.DefaultEStyle.PrimaryEStyle.SuccessEStyle.InfoEStyle.WarningEStyle.Danger
EStyle.Defaulttextstring显示的文字内容。
""textColorcolor文字颜色。
动态绑定titlestring标题文字。
""titleColorcolor标题颜色。
动态绑定topreal对话框顶部位置,单位为像素;非垂直居中时生效。
0visiblebool是否显示组件。
truewidthreal组件尺寸,单位为像素;可绑定父布局尺寸。
动态绑定windowMarginreal对话框与窗口边缘的最小间距,单位为像素。
16loadedContentalias只读通过 Component 创建的实际内容对象。
别名:contentLoader.itemloadedMessageContentalias只读通过 Component 创建的实际内容对象。
别名:messageContentLoader.itemmaximumDialogWidthreal只读扣除窗口边距后的对话框最大宽度。
由运行时计算信号
closeRejected()关闭请求被 beforeClose 拒绝时触发。
openAutoFocused()弹窗打开并完成自动聚焦时触发。
closeAutoFocused()弹窗关闭并完成焦点恢复时触发。
canceled()取消当前操作时触发。
confirmed(string value)确认操作时触发;若有 value 参数,则为确认后的值。
completed(string action, string value)消息框结束时触发,action 为结束操作,value 为输入内容。
方法
close()关闭组件的面板或弹窗。
open()打开组件的面板或弹窗。
resetPosition()将对话框恢复到初始位置。
requestClose()请求关闭弹窗,并执行 beforeClose 检查。
reject()取消当前确认操作。
accept()确认当前操作;输入不符合校验时不会提交。
alert(message, heading)显示提示消息框,message 为内容,heading 为标题。
confirm(message, heading)显示确认消息框,message 为内容,heading 为标题。
prompt(message, heading, initialValue)显示输入消息框,message 为提示,heading 为标题,initialValue 为初始输入值。