Skip to content

Tooltip 文字提示 ​

在悬停(鼠标 / 触控板)或长按(触屏)时显示信息。会自动翻转以保持在屏幕内。

基础用法 ​

网页近似预览,真机效果以 HarmonyOS 渲染为准。

API ​

从组件库源码中的 @Param / @Event / @BuilderParam 声明自动提取。

STooltip ​

shadcn-vue 的 Tooltip,基于系统弹出层(bindPopup:支持翻转的定位、箭头、无遮罩),并做了语义上的转换:

  • 指针:悬停 delay 毫秒后显示,移开后隐藏
  • 触控:长按显示(此时该按压不会作为点按传递给触发器),松开后隐藏
属性类型默认值说明
delaynumber500悬停延迟,单位毫秒(指针)
adaptiveSparkAdaptive
SparkAdaptive = 'auto' | 'pointer' | 'touch'
'auto''auto' 跟随输入方式;'touch' 禁用悬停,'pointer' 禁用长按

插槽: 子组件(尾随闭包)

STooltipTrigger ​

插槽: 子组件(尾随闭包)

STooltipContent ​

bg-primary text-primary-foreground rounded-md px-3 py-1.5 text-xs,带箭头;系统弹出层会将其翻转以保持在屏幕内。

属性类型默认值说明
textResourceStr | undefinedundefined
sideSparkSide
SparkSide = 'top' | 'right' | 'bottom' | 'left'
'top'
alignmentSparkAlign
SparkAlign = 'start' | 'center' | 'end'
'center'
sideOffsetnumber6

插槽: 子组件(尾随闭包)

MIT Licensed