Kaapi UI
Back to Overview

Tooltip

A floating element that displays informative text when triggered by hover, focus, or click. Supports variants, sizes, arrows, controlled state, and positioning options.

Examples

Basic

<Tooltip trigger={<HelpCircle  />} title="Basic tooltip title" />

With Arrow

<Tooltip trigger={<HelpCircle  />} title="Tooltip with arrow" arrow={true} />

Positioning

<Tooltip trigger={<HelpCircle />} title="Tooltip on top" side="top" />
<Tooltip trigger={<HelpCircle />} title="Tooltip on right" side="right" />
<Tooltip trigger={<HelpCircle />} title="Tooltip on bottom" side="bottom" />
<Tooltip trigger={<HelpCircle />} title="Tooltip on left" side="left" />
<Tooltip trigger={<HelpCircle />} title="Aligned start" side="top" align="start" />
<Tooltip trigger={<HelpCircle />} title="Aligned end" side="top" align="end" />

API Reference

All props are specific to the Tooltip component.

PropsTypeDefaultDescription
triggerReactNodeElement that triggers the tooltip.
titlestringThe tooltip title.
side"top" | "right" | "bottom" | "left""top"Side of the trigger to position the tooltip.
align"start" | "center" | "end""center"Alignment relative to the trigger.
sideOffsetnumber6Offset distance from the trigger element.
alignOffsetnumber0Offset along the alignment axis.
arrowbooleanfalseWhether to display the arrow.
variant"default" | "secondary" | "outline""default"Visual style of the tooltip.
size"sm" | "md" | "lg""sm"Size of the tooltip title and arrow.
maxWidth"xs" | "sm" | "md" | "lg" | "none""xs"Maximum width of the tooltip title.
delayDurationnumber300Delay before showing the tooltip in milliseconds.
closeDelaynumber0Delay before closing the tooltip in milliseconds.
openbooleanControlled open state.
defaultOpenbooleanfalseInitial open state for uncontrolled tooltip.
onOpenChange(open: boolean) => voidCallback fired when tooltip open state changes.
contentClassNamestring-Custom classes applied to the tooltip title.