One UI

OneTooltip

默认使用 hover-focus 触发,定位器会按可用空间翻转并限制在视口或自定义容器内。

查看代码收起代码
import { OneButton, OneTooltip } from '@geektech/one';

new OneTooltip({
  content: '复制链接',
  placement: 'bottom-end',
  children: [{ component: OneButton, children: ['复制'] }],
});

示例

new OneTooltip({ content: '复制链接', placement: 'bottom-end', children: [{ component: OneButton, children: ['复制'] }] })

12 个方向

top-start, top, top-end, right-start, right, right-end, bottom-start, bottom, bottom-end, left-start, left, left-end。

API

OneTooltip 属性与事件
名称签名说明
contentcontent: VNode | string提示内容。
placementplacement?: OneOverlayPlacement首选方向,空间不足时自动翻转和位移。
triggertrigger?: 'hover-focus' | 'click' | 'manual'触发方式。
openopen?: boolean受控显示状态。
defaultOpendefaultOpen?: boolean非受控初始状态。
openDelayopenDelay?: number打开延迟,默认 100ms。
closeDelaycloseDelay?: number关闭延迟,默认 100ms。
offsetoffset?: number与触发元素的距离,默认 8px。
containercontainer?: OneOverlayContainer自定义挂载与碰撞边界。
arrowarrow?: boolean是否显示箭头。
disableddisabled?: boolean禁用提示。
childrenchildren?: Array<VNode | string>必须包含一个 HTMLElement 触发节点。
openChange(open: boolean) => void显示状态变更请求。

键盘与 ARIA

气泡使用 role=tooltip,打开时通过 aria-describedby 关联触发元素;focus 可打开,Escape 可关闭,并在卸载时恢复原属性。