Components/Feedback

EPopover Popover

import EUI 1.0

Examples

Popover

QML sourceQML

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: "Click to open" } EPopover { reference: referenceButton text: "Popover content" } }

Preview

Run the code to try the component

Edit text, properties, or events, then select Run.

Code runs in this browser Licenses

Properties

PropertyDescriptionValues and default

alignmentstring

Alignment of the popup relative to its target.

"start" / "center"
"end"

Default"center"

autoCloseint

Delay, throttling or automatic close time in milliseconds; 0 means no delay or no timed close.

Default0

closePolicyenum

Automatic popup closing conditions; flags can be combined.

Popup.* (combine with |)
NoAutoClose
CloseOnPressOutside
CloseOnPressOutsideParent
CloseOnReleaseOutside
CloseOnReleaseOutsideParent
CloseOnEscape

DefaultPopup.CloseOnEscape | Popup.CloseOnPressOutsideParent

contentalias

Content slot; declare QML child objects directly inside the component.

DefaultAlias: customContent.data

contentComponentComponent

Component slot for custom body content; null uses the default content. See this page’s examples for delegate context.

Defaultnull

effectstring

Visual theme of the popup.

"light" / "dark"

Default"light"

enabledbool

Allow interaction; false disables the control.

Defaulttrue

enterablebool

Keep the popup open while the pointer enters it.

Defaulttrue

fallbackPlacementsvar

Alternative popup placements when the preferred position lacks space.

Default[]

focusbool

Whether the popup requests focus.

Defaulttrue

heightreal

Component size in pixels; may be bound to its parent layout.

DefaultimplicitHeight

hideAfterint

Delay, throttling or automatic close time in milliseconds; 0 means no delay or no timed close.

Default120

modalbool

Use a modal popup that blocks interaction with underlying content.

Defaultfalse

offsetreal

Offset relative to layout, scroll target or popup reference, in pixels.

Default8

persistentbool

Keep popup content instantiated after closing.

Defaulttrue

placementint

Display position of the popup or message.

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

DefaultEPlacement.Bottom

rawContentbool

Interpret content as rich text; enable only for trusted content.

Defaultfalse

referenceItem

Visual item used as the popup reference.

Defaultnull

showAfterint

Delay, throttling or automatic close time in milliseconds; 0 means no delay or no timed close.

Default0

showArrowbool

Show the popup or tour arrow.

Defaultfalse

textstring

Displayed text.

Default""

titlestring

Title text.

Default""

triggerstring

Interaction that opens the popup.

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

Default"click"

triggerKeysvar

Array of Qt key codes that trigger the action; an empty array disables keyboard triggering.

Default[Qt.Key_Return, Qt.Key_Enter, Qt.Key_Space]

visiblebool

Whether the component is visible.

Defaulttrue

widthreal

Component size in pixels; may be bound to its parent layout.

DefaultimplicitWidth

effectivePlacementintRead only

Actual popup placement after geometry or step configuration.

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

DefaultComputed at runtime

loadedContentaliasRead only

Actual content item instantiated from a Component.

DefaultAlias: contentLoader.item

popperRefaliasRead only

Reference to the internal menu, popup or tooltip.

DefaultAlias: control

referenceEnabledboolRead only

Whether the popup reference is available, enabled or visible.

DefaultComputed at runtime

referenceHeightrealRead only

Actual dimensions of the popup reference.

DefaultComputed at runtime

referenceHoveredboolRead only

Whether the reference item is hovered.

DefaultComputed at runtime

referenceVisibleboolRead only

Whether the popup reference is available, enabled or visible.

DefaultComputed at runtime

referenceWidthrealRead only

Actual dimensions of the popup reference.

DefaultComputed at runtime

Methods

SignaturePurpose

hide()

Hide the popup content.

toggle()

Toggle the expanded or selected state; pass the target identifier when required.

show()

Show the popup content.