Tooltip

Tooltip shows a brief hint when the wrapped control is hovered or focused — ideal for icon-only buttons and truncated labels. Set content to a short phrase; pick position and appearance for contrast. Always give icon-only triggers an accessible name too; never put required information only in a tooltip.

  • Icon-only buttons, truncated labels, clarifying a control with minimal visible text
  • One short phrase on hover or focus — not interactive content
  • Rich panels, pickers, or action lists — use Popover or Menu
  • Wrap the trigger (e.g. crate::Button) as children.
  • Set content to the hint string (or Signal for dynamic text).
  • Optional: position (Top default), appearance (Normal / Inverted).
  • On disabled buttons that must stay focusable, set disabled_focusable=true on the wrapped Button so keyboard users can reach the tooltip.
Basic tooltip (top)

Short hint on hover or focus for controls with minimal visible labeling. Top is the default when space allows above the trigger.

Inverted appearance

Dark tooltip body on light triggers or when extra contrast is needed on tinted surfaces.

Bottom placement

Opens below the trigger when the control sits under headers or near the top viewport edge.

Left placement

Positions the hint to the left of icon-only toolbar buttons or triggers on the right side of the layout.

Right placement

Positions the hint to the right when the trigger sits on the left margin or left-aligned controls.

Top start (aligned to start edge)

Aligns the tooltip with the start edge of wide triggers—multi-word buttons or split controls.

Bottom end

Aligns with the end edge when the trigger spans most of a row or sits flush to the trailing margin.

Disabled focusable button

Wrap a disabled button with disabled_focusable=true so keyboard users can focus it and read the tooltip.

Show delay

Tooltip opens only after hovering for the configured show delay.

Theme token

Tooltip surface inherits neutral background tokens from the Orbital theme provider.