Tui

Tooltip 提示
提供文字提示功能,适用于鼠标悬停、点击等场景,用于辅助说明或展示补充信息。
基础用法
默认支持点击 click 和悬浮 hover 触发方式,并支持配置显示方向。
示例代码
vue
通过 slot 自定义内容(含 dark)
通过 slot="content" 可自定义提示内容,支持任意 HTML 结构,并可结合 effect="dark" 使用。
示例代码
vue
visible 受控模式
通过 visible 受控显示状态,适用于由业务逻辑统一控制 tooltip 开关的场景。
visible: false
示例代码
vue
隐藏箭头
通过 arrow="false" 隐藏箭头。
示例代码
vue
显示位置
通过 placements 设置显示位置。
示例代码
vue
属性 Props
属性名
说明
类型
可选值
默认值
版本说明
visible
显示状态(受控模式)。传 `null` 时为非受控,由 hover/click 内部触发。
boolean | null
true / false / null
null
arrow
是否显示箭头
boolean
-
true
added 0.5.8
effect
主题
string
light / dark
light
added 0.5.8
nowrap
是否强制不换行(单行显示)
boolean
-
false
added 0.6.5
content
提示内容
string
-
trigger
触发方式
string
hover / click
hover
offset
偏移量
[number,number]
-
[0, 0]
gap
间距
number
-
3
hoverHideDelay
hover 触发下,移出后延迟隐藏时间(ms)
number
-
100
added 0.6.9
placements
位置
string[]
top-start / top-center/ top-end / left-center / right-center / bottom-start/ bottom-center / bottom-end / left-start /right-start / left-end / right-end
['top-start', 'top-center', 'top-end', 'left-center', 'right-center', 'bottom-start', 'bottom-end', 'left-start', 'right-start', 'left-end', 'right-end']
changed 0.5.8 placement to placements
showOnHover
只要鼠标 hover,就显示 tooltip,不考虑是否文本超出
boolean
-
false
deprecated 0.5.8
方法 Methods
方法名
说明
参数
返回值
版本说明
recalculate
手动触发 tooltip 位置重算(如 trigger 元素位置动态变化时)
() => void
-
added 0.6.7
插槽 Slots
插槽名
说明
版本说明
default
默认slot, tooltip 的触发元素
content
自定义内容slot
基础用法
通过 slot 自定义内容(含 dark)
visible 受控模式
隐藏箭头
显示位置
属性 Props
方法 Methods
插槽 Slots