Components
Tooltip

Tooltip

The Tooltip component provides you with help text when the user hovers over an element.

Import

import { Tooltip, TooltipProvider, TooltipTrigger, TooltipContent } from '@nostromo/ui-core'
// or
import { Tooltip, TooltipProvider, TooltipTrigger, TooltipContent } from '@nostromo/ui-core/tooltip'

Usage

import { Tooltip, TooltipProvider, TooltipTrigger, TooltipContent } from '@nostromo/ui-core'
 
export default function Example() {
  return (
    <TooltipProvider>
      <Tooltip>
        <TooltipTrigger>Hover me</TooltipTrigger>
        <TooltipContent>
          <p>This is a tooltip</p>
        </TooltipContent>
      </Tooltip>
    </TooltipProvider>
  )
}

Live Examples

Live Example
☀️
Copy
Storybook →
View Code
import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from '@nostromo/ui-core' export default function TooltipExample() { return ( <TooltipProvider> <Tooltip> <TooltipTrigger>Hover over me</TooltipTrigger> <TooltipContent> <p>This is a tooltip</p> </TooltipContent>...

With Buttons

Live Example
☀️
Copy
Storybook →
View Code
import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, Button } from '@nostromo/ui-core' export default function TooltipWithButton() { return ( <TooltipProvider> <Tooltip> <TooltipTrigger asChild> <Button variant="outline">Hover over button</Button> </TooltipTrigger> <TooltipContent>...

Props

Tooltip

PropTypeDefaultRequiredDescription
contentReact.ReactNode-YesTooltip content
trigger"hover" | "click" | "focus" | "manual""hover"NoHow tooltip is triggered
openbooleanundefinedNoWhether tooltip is open (controlled)
onOpenChange(open: boolean) => voidundefinedNoCallback when open state changes
delayDurationnumber700NoDelay before tooltip shows (ms)
skipDelayDurationnumber300NoDelay before tooltip shows when moving between triggers (ms)
disabledbooleanfalseNoWhether tooltip is disabled
side"top" | "right" | "bottom" | "left""top"NoSide of trigger to align to
align"start" | "center" | "end""center"NoAlignment relative to trigger
sideOffsetnumber4NoDistance from trigger (px)
alignOffsetnumber0NoOffset from alignment (px)
avoidCollisionsbooleantrueNoWhether to adjust position to avoid collisions
collisionBoundaryElement | nullnullNoBoundary element for collision detection
collisionPaddingnumber0NoPadding for collision detection (px)
hideWhenDetachedbooleanfalseNoWhether to hide when trigger is detached
sticky"partial" | "always""partial"NoSticky behavior
closeOnBlurbooleantrueNoWhether to close on blur
classNamestringundefinedNoAdditional CSS classes
contentClassNamestringundefinedNoAdditional CSS classes for content
childrenReact.ReactNodeundefinedNoTooltip trigger element

TooltipProvider

PropTypeDefaultRequiredDescription
delayDurationnumber700NoDefault delay for all tooltips (ms)
skipDelayDurationnumber300NoDefault skip delay for all tooltips (ms)
childrenReact.ReactNode-YesApp content

TooltipTrigger

PropTypeDefaultRequiredDescription
asChildbooleanfalseNoRender as child element
classNamestringundefinedNoAdditional CSS classes
childrenReact.ReactNodeundefinedNoTrigger element

TooltipContent

PropTypeDefaultRequiredDescription
classNamestringundefinedNoAdditional CSS classes
childrenReact.ReactNodeundefinedNoTooltip content