Tooltip

简单的文字提示气泡框。

何时使用

鼠标移入则显示提示,移出消失,气泡浮层不承载复杂文本和操作。

可用来代替系统默认的 ‘title’ 提示,提供一个’按钮/文字/操作’的文案解释。

代码演示


Tooltip will show when mouse enter.

基本

最简单的用法。

expand code expand code

位置

位置有 12 个方向。

expand code expand code

箭头指向

设置了 arrowPointAtCenter 后,箭头将指向目标元素的中心。

expand code expand code


自动调整位置

气泡框不可见时自动调整位置

expand code expand code

API

参数 说明 类型 默认值
title 提示文字 string|slot

共同的 API

以下 API 为 Tooltip、Popconfirm、Popover 共享的 API。

参数 说明 类型 默认值
arrowPointAtCenter 箭头是否指向目标元素中心 boolean false
autoAdjustOverflow 气泡被遮挡时自动调整位置 boolean true
defaultVisible 默认是否显隐 boolean false
getPopupContainer 浮层渲染父节点,默认渲染到 body 上 Function(triggerNode) () => document.body
mouseEnterDelay 鼠标移入后延时多少才显示 Tooltip,单位:秒 number 0
mouseLeaveDelay 鼠标移出后延时多少才隐藏 Tooltip,单位:秒 number 0.1
overlayClassName 卡片类名 string
overlayStyle 卡片样式 object
placement 气泡框位置,可选 top left right bottom topLeft topRight bottomLeft bottomRight leftTop leftBottom rightTop rightBottom string top
trigger 触发行为,可选 hover/focus/click/contextmenu string hover
visible(v-model) 用于手动控制浮层显隐 boolean false
destroyTooltipOnHide 隐藏后是否销毁tooltip boolean false
align 该值将合并到 placement 的配置中,设置参考 dom-align Object

事件

事件名称 说明 回调参数
visibleChange 显示隐藏的回调 (visible) => void

注意

请确保 Tooltip 的子元素能接受 mouseentermouseleavefocusclick 事件。

  Timeline 时间轴Tree 树形控件