Tooltip

Anchored hint that appears on hover or focus.

Introduction

Tooltips show a short hint anchored to a control. They open on hover or focus when you provide a trigger, and close when the pointer leaves or focus moves away.

Use content for plain text, or pass custom markup as children (default slot on Vue). Children win when both are set. Put the opener in the trigger slot, or pass anchorEl for an external anchor.

Tooltip vs Menu: Use Tooltip for brief labels and help text. Use Menu for action lists and interactive choices.

Import

import { Tooltip } from "@bridge-ui/vue/Components/Tooltip";

import { Tooltip } from "@bridge-ui/react/Components/Tooltip";

Basic usage

Provide a trigger via the trigger slot (Vue) or slots.trigger (React). Hover or focus the button to open the tooltip.

External anchor

Pass anchorEl to position against an element outside the tooltip instead of using the trigger slot. Without a trigger, open/close is controlled (show / v-model)—wire hover or focus on the anchor yourself.

Placement

Use placement to position the panel relative to the trigger. The default is top.

Color and size

Style the panel with color, size, and arrow. Default color is dark; size defaults to md. Use black for an inverted high-contrast panel.

Custom body

Pass children (React) or the default slot (Vue) for custom panel content. This overrides content when both are set.

Button, Icon, Menu, Sidebar

Accessibility

Prefer a focusable trigger (for example a Button) so keyboard users can open the tooltip on focus.
Keep tooltip copy short; do not put critical information only in a tooltip.
Hover and focus open the panel after openDelay (default 200 ms); leave/blur closes after closeDelay.
When disabled is true, the tooltip does not open.

Anatomy

<div> <!-- root (when trigger is used) -->
  <div> <!-- trigger wrapper -->
  <div> <!-- portaled content -->
    …panel body…
    <div> <!-- arrow (optional) -->
  </div>
</div>

The panel is portaled to teleportTo (default "body") and positioned relative to the trigger or anchorEl.

API

Prop	Type	Default	Description
@show-change	(show: boolean) => void	—	Emitted when visibility should change.
v-model	boolean	false	Whether the tooltip is visible. Omit for uncontrolled hover/focus with #trigger.

Slot	Description
default	Custom panel body. Wins over content when both are set.
trigger	The trigger element that opens the tooltip.

Prop	Type	Default	Description
children	ReactNode	—	Custom panel body. Wins over content when both are set.
onShowChange	(show: boolean) => void	—	Called when show should change.
show	boolean	—	Whether the tooltip is visible. Omit for uncontrolled hover/focus when using slots.trigger.
slots	TooltipSlots	—	Optional trigger slot for the opener.

Prop	Type	Default	Description
anchorEl	HTMLElement \| RefObject<HTMLElement \| null> \| null	—	External anchor for positioning instead of the trigger.
arrow	boolean	true	Whether the tooltip shows an arrow pointing at the trigger.
classes	TooltipClasses	—	Class overrides for root, trigger, content, and arrow.
closeDelay	number	0	Delay in ms before closing after pointer leave / blur.
color	TooltipColor	"dark"	Semantic color of the tooltip panel.
content	string	—	Plain text for the tooltip panel. Prefer children/default slot for custom markup.
customProps	TooltipCustomProps	—	Extra props for internal parts.
disabled	boolean	false	When true, the tooltip does not open on hover or focus.
offset	number	8	Gap between the trigger and the tooltip panel (px).
openDelay	number	200	Delay in ms before opening after pointer enter / focus.
placement	PositionPlacement	"top"	Preferred placement relative to the anchor.
rounded	TooltipRounded	"md"	Border radius of the tooltip panel.
size	TooltipSize	"md"	Padding and typography of the tooltip panel.
strategy	PositionStrategy	"fixed"	CSS position strategy for the floating panel.
teleportTo	string \| false	"body"	Portal target. Pass false to render in place.