组件/反馈组件

EToolTip 文字提示

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 width: parent.width EButton { text: qsTr("上方提示") EToolTip { text: qsTr("Top") visible: parent.hovered placement: EPlacement.Top } } EButton { text: qsTr("左侧提示") EToolTip { text: qsTr("Left") visible: parent.hovered placement: EPlacement.Left } } }

效果

运行代码，体验组件交互

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

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

属性

属性说明取值与默认值

alignmentstring

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

"start" / "center"
"end"

默认值"center"

arrowOffsetreal

提示箭头相对参考位置的偏移，单位为像素。

默认值16

autoClosealias

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

默认值别名：control.timeout

backgroundColorcolor

背景颜色。

默认值动态绑定

contentComponentComponent

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

默认值null

effectstring

弹层的视觉主题。

"light" / "dark"

默认值"dark"

enabledbool

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

默认值true

enterablebool

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

默认值true

fallbackPlacementsvar

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

默认值[]

focusOnTargetbool

提示关闭后是否把焦点还给参考控件。

默认值false

heightreal

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

默认值implicitHeight

hideAfterint

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

默认值0

offsetreal

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

默认值4

persistentbool

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

默认值true

placementint

弹层或消息的显示位置。

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

默认值EPlacement.Top

rawContentbool

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

默认值false

referenceItem

弹层依附的可视对象。

默认值null

showAfteralias

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

默认值别名：control.delay

showArrowbool

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

默认值true

styleTypeint

语义配色风格。

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

默认值EStyle.Default

textColorcolor

文字颜色。

默认值动态绑定

triggerstring

显示弹层的触发方式。

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

默认值"hover"

triggerKeysvar

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

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

visiblebool

是否显示组件。

默认值true

widthreal

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

默认值implicitWidth

contentHoveredbool只读

鼠标是否悬停在提示内容上。

默认值由运行时计算

contentRefItem只读

提示内容可视对象引用。

默认值由运行时计算

popperRefalias只读

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

默认值别名：control

referenceEnabledbool只读

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

默认值由运行时计算

referenceHoveredbool只读

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

默认值由运行时计算

方法

签名作用

hide()

隐藏组件的弹出内容。

updatePopper()

关联控件位置变化后，更新提示框的位置。

showForReference()

在关联控件旁显示提示内容。