组件/反馈组件

EPopconfirm 气泡确认

import EUI 1.0

示例与代码

气泡确认

QML 代码QML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 Column { spacing: 16 EButton { id: referenceButton text: "点击查看" } EPopconfirm { reference: referenceButton text: "确定执行此操作？" } }

效果

运行代码，体验组件交互

可修改文字、属性和事件，再点击运行。

代码在当前浏览器中运行 许可

属性

属性说明取值与默认值

actionsComponentComponent

自定义操作区的 Component 插槽；null 使用默认内容。 委托上下文见本页示例。

默认值null

alignmentstring

弹层相对于目标的对齐方式。

"start" / "center"
"end"

默认值"center"

autoCloseint

等待、节流或自动关闭时间，单位为毫秒；0 表示不延迟或不启用定时关闭。

默认值0

cancelDisabledbool

禁用取消或确认操作。

默认值false

cancelStyleTypeint

语义配色风格。

EStyle.Default
EStyle.Primary
EStyle.Success
EStyle.Info
EStyle.Warning
EStyle.Danger

默认值EStyle.Default

cancelTextstring

取消按钮文字。

默认值随当前语言变化

closePolicyenum

弹层自动关闭的触发条件，可组合多个条件。

Popup.*（可用 | 组合）
NoAutoClose
CloseOnPressOutside
CloseOnPressOutsideParent
CloseOnReleaseOutside
CloseOnReleaseOutsideParent
CloseOnEscape

默认值Popup.CloseOnEscape | Popup.CloseOnPressOutsideParent

confirmDisabledbool

禁用取消或确认操作。

默认值false

confirmStyleTypeint

语义配色风格。

EStyle.Default
EStyle.Primary
EStyle.Success
EStyle.Info
EStyle.Warning
EStyle.Danger

默认值EStyle.Primary

confirmTextstring

确认按钮文字。

默认值随当前语言变化

contentalias

内容插槽；直接在组件内部声明 QML 子对象。

默认值别名：customContent.data

contentComponentComponent

自定义主体内容的 Component 插槽；null 使用默认内容。 委托上下文见本页示例。

默认值null

effectstring

弹层的视觉主题。

"light" / "dark"

默认值"light"

enabledbool

是否允许交互；false 时控件禁用。

默认值true

enterablebool

是否允许鼠标进入浮层而不关闭。

默认值true

fallbackPlacementsvar

首选位置空间不足时尝试的位置数组。

默认值[]

focusbool

是否请求弹层焦点。

默认值true

heightreal

组件尺寸，单位为像素；可绑定父布局尺寸。

默认值implicitHeight

hideAfterint

等待、节流或自动关闭时间，单位为毫秒；0 表示不延迟或不启用定时关闭。

默认值120

hideIconbool

隐藏气泡确认图标。

默认值false

iconColorcolor

图标颜色。

默认值动态绑定

iconSourceint

组件使用的图标。

EIcons.*
0（无图标）

默认值EIcons.CIRCLE_QUESTION

modalbool

使用模态弹层，阻止对下层内容的交互。

默认值false

offsetreal

相对布局、滚动目标或弹层参考对象的偏移；单位为像素。

默认值8

persistentbool

关闭后保留弹层内容实例。

默认值true

placementint

弹层或消息的显示位置。

EPlacement.TopLeft
EPlacement.Top
EPlacement.TopRight
EPlacement.Left
EPlacement.Right
EPlacement.BottomLeft
EPlacement.Bottom
EPlacement.BottomRight

默认值EPlacement.Bottom

rawContentbool

按富文本解释内容；仅应对可信内容启用。

默认值false

referenceItem

弹层依附的可视对象。

默认值null

showAfterint

等待、节流或自动关闭时间，单位为毫秒；0 表示不延迟或不启用定时关闭。

默认值0

showArrowbool

是否显示弹层或引导箭头。

默认值false

textstring

显示的文字内容。

默认值""

titlestring

标题文字。

默认值随当前语言变化

triggerstring

显示弹层的触发方式。

"click" / "hover"
"focus" / "contextmenu"
"manual"

默认值"click"

triggerKeysvar

触发操作的 Qt 键值数组；空数组禁用键盘触发。

默认值[Qt.Key_Return, Qt.Key_Enter, Qt.Key_Space]

visiblebool

是否显示组件。

默认值true

widthreal

组件尺寸，单位为像素；可绑定父布局尺寸。

默认值implicitWidth

effectivePlacementint只读

经过空间计算或步骤配置处理的实际弹层位置。

EPlacement.TopLeft
EPlacement.Top
EPlacement.TopRight
EPlacement.Left
EPlacement.Right
EPlacement.BottomLeft
EPlacement.Bottom
EPlacement.BottomRight

默认值由运行时计算

loadedContentalias只读

通过 Component 创建的实际内容对象。

默认值别名：contentLoader.item

popperRefalias只读

内部菜单、弹层或提示对象引用。

默认值别名：control

referenceEnabledbool只读

弹层参考对象是否可用、可交互或可见。

默认值由运行时计算

referenceHeightreal只读

弹层参考对象的实际尺寸。

默认值由运行时计算

referenceHoveredbool只读

参考对象是否处于鼠标悬停状态。

默认值由运行时计算

referenceVisiblebool只读

弹层参考对象是否可用、可交互或可见。

默认值由运行时计算

referenceWidthreal只读

弹层参考对象的实际尺寸。

默认值由运行时计算

信号

签名作用

canceled()

取消当前操作时触发。

confirmed()

确认操作时触发；若有 value 参数，则为确认后的值。

方法

签名作用

hide()

隐藏组件的弹出内容。

toggle()

切换当前展开或选中状态；需要标识时传入目标项的标识。

show()

显示组件的弹出内容。

reject()

取消当前确认操作。

accept()

确认当前操作；输入不符合校验时不会提交。