Tooltip

工具提示:悬停或聚焦触发,自动测量定位并在空间不足时翻转,只承载不可交互的短文案。

属性

属性类型默认值说明
openboolean—受控开关
defaultOpenbooleanfalse非受控初始开关
onOpenChange(open: boolean) => void—开关变化回调
delaynumber200悬停多久后显示(毫秒),键盘聚焦立即显示
placement'top' | 'bottom' | 'left' | 'right''top'期望方向:top / bottom / left / right
align'start' | 'center' | 'end''center'交叉轴对齐:start / center / end
offsetnumber8与触发元素的间距
Tooltip.TriggerButtonHTMLAttributes—触发按钮,负责悬停 / 聚焦逻辑
Tooltip.ContentHTMLAttributes—提示内容,role="tooltip",不可交互