Simple Tooltip for React

Use a Tooltip for a short, supplementary label, a few words that clarify a control people can already see. For a longer explanation, or content with links and inputs, use a Popover, which opens on click and stays open. Anything essential belongs on the page: hover-only text is easy to miss.

The trigger and the Button are one element, so there is no extra wrapper and no button nested in a button. TooltipTrigger renders the Button through render, with the label as its children.

As long as the trigger is hovered or focused: the Tooltip never times out while someone is reading it. It opens without a delay by default and closes when the pointer leaves or the trigger loses focus. Set delay and closeDelay on TooltipTrigger, or delay on the TooltipProvider.

It opens when the trigger gets keyboard focus and closes on Escape. The trigger still needs its own accessible name, here its visible label, because the tooltip only supplements it. Base UI does not link the text to the trigger, so don't rely on the tooltip to name or describe the control.

Not as a hover hint: touch screens have no hover, so a Tooltip mostly shows when its trigger gets focus. Make sure everything people need is readable without it, and use a Popover or inline text where a phone user must see the explanation.

Elements people can focus: buttons, links and form controls, so keyboard users can open the Tooltip too. A disabled button gets no hover or focus, so wrap it in a span if it needs a tooltip. Give an icon-only button an aria-label, and mark the icon aria-hidden.