组件Overlays
Tooltip
@mox-hub/ui 组件 · Overlays · canonical
tooltip@mox-hub/uiOverlayscanonicalsrc/components/tooltip.tsx变体演示tooltip
Props API
| Prop | 类型 | 默认值 | 说明 |
|---|---|---|---|
| delayDuration* | number | — | — |
源码
import { Tooltip as TooltipPrimitive } from "@base-ui/react/tooltip"
import { cn } from "../lib/utils"
function TooltipProvider({
delay = 0,
...props
}: TooltipPrimitive.Provider.Props) {
return (
<TooltipPrimitive.Provider
data-slot="tooltip-provider"
delay={delay}
{...props}
/>
)
}
// 兼容层:delayDuration(历史 prop)映射为 base-ui Provider 的 delay
function Tooltip({
delayDuration,
...props
}: TooltipPrimitive.Root.Props & { delayDuration?: number }) {
if (delayDuration === undefined) {
return <TooltipPrimitive.Root data-slot="tooltip" {...props} />
}
return (
<TooltipPrimitive.Provider delay={delayDuration}>
<TooltipPrimitive.Root data-slot="tooltip" {...props} />
</TooltipPrimitive.Provider>
)
}
// 组合方式:唯一走 base-ui 原生 `render` prop(宪法 §10.7)。
// Radix 遗产 `asChild` 已于批 6b 移除(base-ui 不认该 prop,会透传到 DOM
// 并另渲染一个自带 <button>,产生非法嵌套结构)。
function TooltipTrigger({
children,
...props
}: TooltipPrimitive.Trigger.Props) {
return (
<TooltipPrimitive.Trigger data-slot="tooltip-trigger" {...props}>
{children}
</TooltipPrimitive.Trigger>
)
}
function TooltipContent({
className,
side = "top",
sideOffset = 4,
align = "center",
alignOffset = 0,
children,
...props
}: TooltipPrimitive.Popup.Props &
Pick<
TooltipPrimitive.Positioner.Props,
"align" | "alignOffset" | "side" | "sideOffset"
>) {
return (
<TooltipPrimitive.Portal>
<TooltipPrimitive.Positioner
align={align}
alignOffset={alignOffset}
side={side}
sideOffset={sideOffset}
className="isolate z-modal"
>
<TooltipPrimitive.Popup
data-slot="tooltip-content"
className={cn(
"z-modal inline-flex w-fit max-w-xs origin-(--transform-origin) items-center gap-1.5 rounded-md bg-foreground px-3 py-1.5 text-xs text-background duration-fast has-data-[slot=kbd]:pe-1.5 data-[side=bottom]:slide-in-from-top-2 data-[side=inline-end]:slide-in-from-left-2 data-[side=inline-start]:slide-in-from-right-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 **:data-[slot=kbd]:relative **:data-[slot=kbd]:isolate **:data-[slot=kbd]:z-modal **:data-[slot=kbd]:rounded-sm data-open:animate-in data-open:fade-in-0 data-open:zoom-in-95 data-closed:animate-out data-closed:fade-out-0 data-closed:zoom-out-95",
className
)}
{...props}
>
{children}
<TooltipPrimitive.Arrow className="z-modal size-2.5 translate-y-[calc(-50%-2px)] rotate-45 rounded-xs bg-foreground fill-foreground data-[side=bottom]:top-1 data-[side=inline-end]:top-1/2! data-[side=inline-end]:-left-1 data-[side=inline-end]:-translate-y-1/2 data-[side=inline-start]:top-1/2! data-[side=inline-start]:-right-1 data-[side=inline-start]:-translate-y-1/2 data-[side=left]:top-1/2! data-[side=left]:-right-1 data-[side=left]:-translate-y-1/2 data-[side=right]:top-1/2! data-[side=right]:-left-1 data-[side=right]:-translate-y-1/2 data-[side=top]:-bottom-2.5" />
</TooltipPrimitive.Popup>
</TooltipPrimitive.Positioner>
</TooltipPrimitive.Portal>
)
}
export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider }
可访问性与 RTL
- 键盘:交互件保留
:focus-visible焦点环;浮层支持 Escape 关闭与焦点归还,菜单 / 页签按 Base UI 约定支持方向键。 筛选菜单、拖拽排序、执行树与模型 listbox 等关键键盘流由 Playwright 断言覆盖,见规范示例 · 交互与可访问性。 - RTL:间距、对齐与方向性图标使用逻辑属性 (
ms-*/text-start/rtl:-scale-x-100);通过ThemeProvider或I18nProvider的direction="rtl"驱动,`lint:rtl` 会拦截新增物理类。 - 文案:优先用组件
labels/translate/translatorprops,其次用I18nProvider目录;内置 zh-CN 默认值,en-US 为参考翻译。见Theming · i18n 与 RTL。 - 对比度:高对比度 token、2px 控件边框与 3px 焦点环由主题层统一提供,见Foundations · Contrast。
用法说明
简短说明气泡,由 Tooltip、Trigger、Content 组合;触发器需可聚焦,内容不承载交互。