组件/反馈组件

EPopover 弹出框

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: "点击查看" } EPopover { reference: referenceButton text: "这里是弹出内容" } }

效果

运行代码，体验组件交互

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

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

属性

属性说明取值与默认值

alignmentstring

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

"start" / "center"
"end"

默认值"center"

autoCloseint

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

默认值0

closePolicyenum

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

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

默认值Popup.CloseOnEscape | Popup.CloseOnPressOutsideParent

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

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只读

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

默认值由运行时计算

方法

签名作用

hide()

隐藏组件的弹出内容。

toggle()

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

show()

显示组件的弹出内容。