Skip to content

Tooltip 提示

Tooltip 提示组件,用于在鼠标悬停时显示提示信息。

基础用法

不同位置

自定义延迟

自定义内容(插槽)

边缘自动调整

靠近视口边缘时,Tooltip 会自动翻转方向以避免超出屏幕。

API

Props

属性类型默认值说明
contentstring''提示内容
placement'top' | 'bottom' | 'left' | 'right''top'提示位置
delaynumber0显示延迟(毫秒)
offsetnumber8与触发元素的偏移量(像素)

Slots

名称说明
trigger触发元素(如使用默认插槽则自动包裹)
default触发元素的默认插槽(优先级低于 trigger
content自定义提示内容(优先级高于 content prop)

注意事项

  • Tooltip 默认在 hover 时触发,不支持 click 或 focus 模式
  • 提示内容为纯文本时用 content prop,复杂内容用 #content 插槽
  • 靠近视口边缘时自动翻转方向(防止超出屏幕)
  • Tooltip 使用 Teleport 挂载到 body,避免被父容器裁剪
  • 支持延迟显示,适合防止误触

Released under the MIT License