Components/Feedback

EToolTip Tooltip

import EUI 1.0

Examples

Tooltip

QML sourceQML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 Column { spacing: 16 width: parent.width EButton { text: qsTr("Top tooltip") EToolTip { text: qsTr("Top") visible: parent.hovered placement: EPlacement.Top } } EButton { text: qsTr("Left tooltip") EToolTip { text: qsTr("Left") visible: parent.hovered placement: EPlacement.Left } } }

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"

arrowOffsetreal

Tooltip arrow offset from the reference position in pixels.

Default16

autoClosealias

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

DefaultAlias: control.timeout

backgroundColorcolor

Background color.

DefaultDynamic binding

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"dark"

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[]

focusOnTargetbool

Restore focus to the reference control when the tooltip closes.

Defaultfalse

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.

Default0

offsetreal

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

Default4

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.Top

rawContentbool

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

Defaultfalse

referenceItem

Visual item used as the popup reference.

Defaultnull

showAfteralias

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

DefaultAlias: control.delay

showArrowbool

Show the popup or tour arrow.

Defaulttrue

styleTypeint

Semantic color style.

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

DefaultEStyle.Default

textColorcolor

Text color.

DefaultDynamic binding

triggerstring

Interaction that opens the popup.

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

Default"hover"

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

contentHoveredboolRead only

Whether tooltip content is hovered.

DefaultComputed at runtime

contentRefItemRead only

Reference to the tooltip content item.

DefaultComputed at runtime

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

referenceHoveredboolRead only

Whether the reference item is hovered.

DefaultComputed at runtime

Methods

SignaturePurpose

hide()

Hide the popup content.

updatePopper()

Update the tooltip position after its reference control moves.

showForReference()

Show the tooltip beside its reference control.