Svelte Tooltip - Bitblue

Contextual tooltips positioned with Floating UI on hover or click

Setup

<script lang="ts">
	import { Button, Tooltip } from '@cailabs/components.base';
</script>

Default tooltip

<script lang="ts">
	import { Button, Tooltip } from '@cailabs/components.base';
</script>

<Button id="tip-default">Hover me</Button>
<Tooltip triggeredBy="#tip-default">Tooltip content</Tooltip>

Placement

<script lang="ts">
	import { Button, Tooltip } from '@cailabs/components.base';
</script>

<Button id="tip-top">Top</Button>
<Tooltip triggeredBy="#tip-top" placement="top">Top tooltip</Tooltip>

Light type

<script lang="ts">
	import { Button, Tooltip } from '@cailabs/components.base';
</script>

<Button id="tip-light">Light tooltip</Button>
<Tooltip triggeredBy="#tip-light" type="light">Light style</Tooltip>

Colors

Optional color tokens (override type fill): primary, secondary, gray, red, orange, amber, yellow, lime, green, emerald, teal, cyan, sky, blue, indigo, violet, purple, fuchsia, pink, rose.

type variants: dark, light, auto, custom.

Composition notes

  • Always pair with a trigger element and set triggeredBy to its selector (usually #id).
  • Prefer trigger="hover" for tooltips; use click for touch-friendly tips.
  • Extends the shared Popper API used by Dropdown / Popover.

Props

TooltipProps (extends PopperProps)

PropTypeDefaultDescription
childrenSnippet—Tooltip content
typedark | light | auto | customdarkVisual style
colorcolor token—Solid color override
triggeredBystring—CSS selector for trigger
triggerhover | clickhoverOpen behavior
triggerDelaynumber—Hover delay (ms)
placementFloating UI PlacementtopPosition
strategyFloating UI Strategy—absolute / fixed
offsetnumber—Distance from trigger
arrowbooleantrueShow arrow
arrowClassstring—Arrow classes
referencestring—Alternate reference selector
middlewaresMiddleware[]—Floating UI middleware
yOnlyboolean—Constrain movement to Y
isOpenbooleanfalseBindable open state
transitionTransitionFunc—Open/close transition
transitionParamsParamsType—Transition params
onbeforetoggle(ev) => void—Before open/close
ontoggle(ev) => void—After open/close
classClassValue—Root classes

Events

EventDescription
onbeforetoggleBefore visibility change (TriggeredToggleEvent)
ontoggleAfter visibility change

© 2026 Bitblue is a registered trademark. All Rights Reserved.