Documentation Index
Fetch the complete documentation index at: https://docs.cognite.com/llms.txt
Use this file to discover all available pages before exploring further.
Tooltip
v1.0.0 | View in StorybookWhen to use
- Clarification: Use Tooltips when there’s a need to explain UI elements that may not be self-explanatory.
- Icons Buttons: When controls use icons without labels, or the label needs more clarity, a Tooltip can provide context or detail.
- Short instructions: Use Tooltips for brief instructions or details that would otherwise clutter the main interface if shown all the time.
- Non-critical info: Tooltips are best used for supplementary or optional information that does not require immediate attention.
When to use something else
- Long copy: use inline text, side panels, or Alert—not a Tooltip.
- Critical or frequently needed information: surface it in the layout or Dialog, not only in a tooltip.
- Redundant text: don’t mirror the visible Button label in the tooltip.
Behavior
- On hover: The Tooltip should appear when the user hovers over or focuses on the trigger element and disappear when the hover/focus is removed.
- On focus (accessibility): Tooltips should also activate when the user focuses on an element using the keyboard (e.g., pressing Tab to navigate between buttons). This ensures that screen reader users and keyboard-only users can interact with the Tooltips.
- Delay: Introduce a slight delay before showing the Tooltip (e.g., 200ms-500ms).
Often used with
- Icon-only Button, Toggle group segments, compact Toolbar items—always with an accessible name on the trigger, not only the tooltip.