组件
文字提示 Tooltip
Tooltip:工具提示。它是最小的浮层:一小块紧凑的墨色内容在锚点上方淡入。部件:Root、Trigger、Positioner、Content、Arrow、ArrowTip。
#基础用法
Ink answers only when asked.
<script setup lang="ts">
import { download } from "@bysages/icons";
import { Button, Icon, Tooltip } from "@bysages/vue";
</script>
<template>
<Tooltip.Root>
<Tooltip.Trigger as-child>
<Button variant="outline" size="sm">
<Icon :glyph="download" />
Hover me
</Button>
</Tooltip.Trigger>
<Tooltip.Positioner>
<Tooltip.Content>Ink answers only when asked.</Tooltip.Content>
</Tooltip.Positioner>
</Tooltip.Root>
</template>
#属性
#ArrowTip
纯造型的部件——自身没有属性,沿用部件结构的共享样式。
#Arrow
纯造型的部件——自身没有属性,沿用部件结构的共享样式。
#Content
纯造型的部件——自身没有属性,沿用部件结构的共享样式。
#Positioner
纯造型的部件——自身没有属性,沿用部件结构的共享样式。
#Root
| 属性 | 类型 | 默认值 | 描述 |
|---|---|---|---|
aria-label | string | tooltip 的自定义标签 | |
closeDelay | number | 500 | tooltip 的关闭延迟 |
closeOnClick | boolean | true | 点击时是否关闭 tooltip |
closeOnEscape | boolean | true | 按 Escape 时是否关闭 tooltip |
closeOnPointerDown | boolean | true | pointerdown 时是否关闭 tooltip |
closeOnScroll | boolean | true | 滚动时是否关闭 tooltip |
defaultOpen | boolean | tooltip 渲染时的初始打开状态;不需要控制打开状态时使用 | |
defaultTriggerValue | string | null | 触发器的初始值;不需要控制触发器值时使用 | |
disabled | boolean | tooltip 是否禁用 | |
id | string | 组件内部状态机的唯一标识 | |
ids | Partial<{ trigger: string; content: string; arrow: string; positioner: string; }> | tooltip 各元素的 id,适合组合使用 | |
interactive | boolean | false | tooltip 内容是否可交互;此模式下,悬停内容时 tooltip 保持打开,参见 https://www.w3.org/TR/WCAG21/#content-on-hover-or-focus |
open | boolean | tooltip 的受控打开状态 | |
openDelay | number | 1000 | tooltip 的打开延迟 |
positioning | tooltip.PositioningOptions | popover 内容的定位选项 | |
triggerValue | string | null | 当前打开 tooltip 的触发器值 |
#Trigger
| 属性 | 类型 | 默认值 | 描述 |
|---|---|---|---|
value | string | 标识该触发器的值 |