Skip to content

TooltipPro

A small label for one control: shows after a short rest and at once on keyboard focus, neighbours follow instantly, a shortcut inside, a rich form with a title.

oxyn add tooltip
Search runs
The code is part of Oxyn Pro

The preview stays free for everyone. Pro opens the code of every Pro component, screen, agent-app template, block and kit, plus the Pro CLI.

Get Pro

Rendered from Rust at build time · goes live when visible

When to use

  • A small label for one control: shows after a short rest and at once on keyboard focus, neighbours follow instantly, a shortcut inside, a rich form with a title.

When not to use

  • Actions and choices behind any trigger: use Dropdown Menu instead.
  • Eight variants and five sizes, with a shimmering loading state, a progress fill, press-and-hold for destructive actions and a shortcut chip: use Button instead.
  • An app sidebar: use Sidebar instead.

Installation

Tooltip is part of Oxyn Pro; the preview is free. Pro items install with the oxyn CLI once your licence is signed in; until then Pro members copy the code from this page.

Terminal
oxyn add tooltip

Usage

Dioxus · rust
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Examples

Shortcut

Label with its shortcut.

Search runs
Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Bottom

Below the control.

Search runs
Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Rich

A title line and text.

Run testsRuns the full suite on a fresh worktree.
Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Hover

Real hover: rest the pointer on it.

Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

API reference

Tooltip

PropTypeDefaultDescription
contentrequiredString—Text (becomes the trigger's description).
titleOption<String>Default::default()Rich: a title line above the text.
shortcutOption<String>Default::default()Shortcut shown inside.
sideString"top"`top` · `bottom` · `left` · `right`.
alignString"center"`start` · `center` · `end`.
offsetf326.0Gap px (6).
delayu32500Hover delay ms (500).
disabledboolDefault::default()Never shows.
openOption<bool>Default::default()Force open (review sheets) / controlled.
on_open_changeEventHandler<bool>—Open state changed.
childrenrequiredElement—The trigger.

TooltipProvider

PropTypeDefaultDescription
childrenrequiredElement——

Read from the Rust signature and doc comments.

Keyboard interactions

KeyAction
TabFocus shows it at once
EscHide it

Accessibility

  • The text becomes the trigger's description (aria-describedby).
  • Wrap the app in TooltipProvider so neighbouring tooltips open without a second delay.

Responsive behaviour

  • side picks where it opens; it never takes focus.

Notes for AI

  • Import Tooltip, TooltipProvider from oxyn_dioxus and include PRIMITIVES_CSS plus the token stylesheet once.
  • A GPUI version exists: TooltipEl in oxyn_gpui.
  • Props to set first: content, children, children.
  • Keep its states and timings as they ship; restyle it through the CSS variables rather than by hand.

Guides

Oxyn · 74 free components · 264 Pro components · 96 screens · 20 blocks · Dioxus and GPUI