Skip to content

Tooltip 提示

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

何时使用:需要在鼠标悬停时显示简短说明文字时使用。富内容请使用 Popover。

基础用法

不同位置

自定义延迟

自定义内容(插槽)

边缘自动调整

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

API

Props

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

Slots

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

注意事项

  • Tooltip 支持 hover 和键盘 focus 两种触发方式:鼠标悬停或 Tab 聚焦时显示,移出/失焦时隐藏;不支持 click 模式
  • 提示内容为纯文本时用 content prop,复杂内容用 #content 插槽
  • 靠近视口边缘时自动翻转方向(防止超出屏幕)
  • Tooltip 使用 Teleport 挂载到 body,避免被父容器裁剪
  • 支持延迟显示,适合防止误触
  • 无障碍:显示时触发元素自动关联 aria-describedby,屏幕阅读器可正确读取提示内容;键盘用户可通过 Tab 聚焦查看提示;按 Escape 键可关闭提示
  • 完全支持 SSR,useId() 保证服务端渲染与客户端 hydration 的关联 ID 一致

Released under the MIT License