跳转到正文

Tooltip 文字提示

Tooltip 是一个轻量的上下文提示浮层,支持 hover、focus 和手动控制三种触发方式,内部使用 @floating-ui/vue 完成定位,并通过 aria-describedby 将触发元素和提示内容关联起来。

基础用法

聚焦触发

手动控制

接口说明

属性

名称类型默认值说明
contentstring''未提供 content 插槽时使用的提示内容。
openbooleanundefined受控打开状态。
placementTooltipPlacement'top'浮层定位方向。
trigger'hover' | 'focus' | 'manual''hover'触发策略。
teleportstring | HTMLElement | false'body'浮层 Teleport 目标。
disabledbooleanfalse是否禁用提示显示。

事件

名称签名说明
update:open(open: boolean) => void组件请求更新打开状态时触发。
visible-change(open: boolean) => void当前显隐状态变化时触发。

插槽

名称签名说明
default() => VNode[]触发内容。
content() => VNode[]自定义提示浮层内容。

基于 MIT 协议开源发布。