Tooltips are text labels that appear when the user hovers over, focuses on, or touches an element on the screen.
Use tooltips to further explain concepts, terms, or actions that are not immediately clear or well known, but are not necessary for users to complete an action.
Do not use them for information the user needs, it hides important information from the user. For example, the user should not need to scroll over a tooltip to find out that a button is disabled.
Do not use tooltips for disabled elements, such as buttons. It should be clear to the user why the button is disabled, without the tooltip needing to be revealed first.
Do not use tooltips for rich information (such as images and formatted text). Avoid using them over plain text or other places where users will not be able to find them.
In some cases you may need the tooltip element to exist outside of the element it is a tooltip for, in which case you can use the
is-detached class with the
To import just this component into your project, copy the snippet below and include it in your main Sass file.
// import Vanilla and include base mixins
// this only needs to happen once in a given project
For more information see Customising Vanilla in your projects, which includes overrides and importing instructions.
You can use tooltips in React by installing our react-component library and importing
For an alternative way of displaying discoverable information view our contextual menu component.