Tooltips are floating containers for displaying additional information for the currently focused element. A tooltip can be useful when you want to e.g. give a hint about an existing Command Menu shortcut.
<nord-stack align-items="center" style="margin: var(--n-space-xl) auto">
<nord-button aria-describedby="tooltip">View tooltip</nord-button>
<nord-tooltip id="tooltip">I'm a tooltip</nord-tooltip>
Control the position of the tooltip component. When set to "none", the tooltip will be shown above but accommodate for browser boundaries.
The tooltip role, set on the component by default.
The id for the active element to reference via aria-describedby.
The delay in milliseconds before the tooltip is opened.
|Default slot||The tooltip content|
|Optional slot that holds shortcut keys to access the subject|
This section includes guidelines for designers and developers about the usage of this component in different contexts.
- Use a tooltip if an interactive element requires more explanation.
- Use a tooltip to provide additional information, such as UI shortcuts.
- Use the
labelattribute on icons used for shortcuts for accessibility.
- Use clear and accurate phrasing.
- Be consistent with positioning of tooltips in the user interface.
- Don’t use interactive elements such as links or buttons inside a tooltip.
- Don’t rely on tooltips when you have room to provide more explanation.
- Don’t depend on tooltips for vital information.
Content guidelines #
Tooltips should be clear and informative, but not imperative to using the interface they refer to. They should not contain interactive elements such as buttons or links.
Tooltips should provide useful information and not repeat information that is already present.
When writing tooltips, always write them in sentence case, not title case. The first word should be capitalized and the rest lowercase (unless a proper noun):
Use tooltips sparingly. If your UI is requiring a lot of tooltips, consider revising the interface to provide better explanations and better labelling.
Additional considerations #
- Always provide a tooltip for icon-only buttons or a button with an associated keyboard shortcut.
- Don’t use tooltip to communicate critical information, including errors.
- Use sparingly. If you’re building something that requires a lot of tooltips, take a step back and work on clarifying the design and the language used instead.
Nord provides a lightweight solution for localizing its components. Not all components need localizing, as for the most part snippets of text are set per instance. For full localization guidelines, please see Localization documentation.
If you experience any issues while using Nord Web Components, please head over to the Support page for more guidelines and ways to contact us.