Tooltip 文字提示
在悬停(鼠标 / 触控板)或长按(触屏)时显示信息。会自动翻转以保持在屏幕内。
基础用法
网页近似预览,真机效果以 HarmonyOS 渲染为准。
API
从组件库源码中的 @Param / @Event / @BuilderParam 声明自动提取。
STooltip
shadcn-vue 的 Tooltip,基于系统弹出层(bindPopup:支持翻转的定位、箭头、无遮罩),并做了语义上的转换:
- 指针:悬停
delay毫秒后显示,移开后隐藏 - 触控:长按显示(此时该按压不会作为点按传递给触发器),松开后隐藏
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
delay | number | 500 | 悬停延迟,单位毫秒(指针) |
adaptive | SparkAdaptiveSparkAdaptive = 'auto' | 'pointer' | 'touch' | 'auto' | 'auto' 跟随输入方式;'touch' 禁用悬停,'pointer' 禁用长按 |
插槽: 子组件(尾随闭包)
STooltipTrigger
插槽: 子组件(尾随闭包)
STooltipContent
bg-primary text-primary-foreground rounded-md px-3 py-1.5 text-xs,带箭头;系统弹出层会将其翻转以保持在屏幕内。
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
text | ResourceStr | undefined | undefined | |
side | SparkSideSparkSide = 'top' | 'right' | 'bottom' | 'left' | 'top' | |
alignment | SparkAlignSparkAlign = 'start' | 'center' | 'end' | 'center' | |
sideOffset | number | 6 |
插槽: 子组件(尾随闭包)