Tooltip

Tooltips are used to display helpful information on hover or focus, enhancing clarity without cluttering the UI.
Local
The Tooltip uses the Popper system for its open and close animations, controlled through Classic Interactions found in the right-side Interactions tab alongside Style and Settings. These interactions are connected to the Dropdown component within the Popper structure and are named Popper Open and Popper Close.

‍Popper Open runs when the Dropdown enters its open state, while Popper Close runs when the Dropdown returns to its closed state. Both interactions use the native Dropdown states to control the corresponding Tooltip entrance and exit animations.

Keep these interactions connected to the Dropdown component and the documented Popper structure so the Tooltip animations remain synchronized with the Dropdown's open and closed states.

Popper Positioning

The Tooltip uses the position-static class on the main popper container, allowing popper-navigation to be positioned relative to the parent element rather than the Popper itself. To position the navigation panel relative to the popper container instead, remove the position-static class. Placement modifiers continue to control the panel’s alignment and adaptive positioning behavior. For additional configuration details, refer to the Popper page.
Float
popper
position-static
|
|
popper-toggle
|
popper-navigation
is-float-*
|
|
popper-content
Bottom / Start
popper-navigation
is-float-bottom-start
Bottom / Center (Default)
popper-navigation
Bottom / End
popper-navigation
is-float-bottom-end
Top / Start
popper-navigation
is-float-top-start
Top / Center
popper-navigation
is-float-top
Top / End
popper-navigation
is-float-top-end
Right / Start
popper-navigation
is-float-right-start
Right / Center
popper-navigation
is-float-right
Right / End
popper-navigation
is-float-right-end
Left / Start
popper-navigation
is-float-left-start
Left / Center
popper-navigation
is-float-left
Left / End
popper-navigation
is-float-left-end
Top / Start (Diagonal)
popper-navigation
is-float-right-start
is-diagonal
Top / End (Diagonal)
popper-navigation
is-float-left-start
is-diagonal
Bottom / Start (Diagonal)
popper-navigation
is-float-right-end
is-diagonal
Bottom / End (Diagonal)
popper-navigation
is-float-left-end
is-diagonal
Overlay
popper
position-static
|
|
popper-toggle
|
popper-navigation
is-overlay-*
|
|
popper-content
Center / Center
popper-navigation
is-overlay
Bottom / Start
popper-navigation
is-overlay-bottom-start
Bottom / Center
popper-navigation
is-overlay-bottom
Bottom / End
popper-navigation
is-overlay-bottom-end
Top / Start
popper-navigation
is-overlay-top-start
Top / Center
popper-navigation
is-overlay-top
Top / End
popper-navigation
is-overlay-top-end
Right / Center
popper-navigation
is-overlay-right
Left / Center
popper-navigation
is-overlay-left

Supporting Custom Behavior

Custom behavior components required for this system to function correctly. These components are nested within
Global
so updates can be managed from one central location. Any edits made below will automatically apply across the site.
Custom Behavior -
Popper

This behavior keeps popper menus inside the viewport by automatically adjusting their placement when they open, resize, or move near the edge of the screen. Each popper starts from its preferred placement class, then switches to the best available position only when needed. Bridge and arrow elements are also updated to match the active placement. View the full documentation for setup, structure, and usage details.

Local Tooltip - User Guide

In this tooltip configuration, the popper navigation opens relative to the first parent element that has a positioning context (relative, absolute, fixed, or sticky). This allows the parent container to control the horizontal alignment and available width of the popper content.

A combo class position-static is applied to the popper element to disable its default positioning logic. This enables the parent element to define the width and alignment behavior of the tooltip content.

If you prefer the tooltip to align directly with the toggle element instead of the parent container, simply remove the position-static combo class. The popper will then position itself relative to its trigger as defined by the placement modifiers. The popper styles are structured intentionally to give you different options for how the popper behaves and aligns within the layout. In this setup, the tooltip is aligned with the parent element to create a separate placement style. For setups that need a bridge and arrow, refer to the Popper page and choose one of the complete positioning setups available there. These setups already include the required popper-bridge, popper-arrow, and arrow background styling, making it easier to copy the correct structure and adapt it for your tooltip.

For longer tooltip content, it is recommended to wrap the popper-content inside a container with a fixed or controlled width to maintain readability and layout stability. For complete container sizing options, refer to the Width & Height page.

The tooltip popper is configured to open and close on hover by default. If click-based interaction is preferred, this behavior can be modified in the Settings panel of the popper element.
Global

Popover Positioning

An attribute-driven popover system that allows multiple triggers and targets to interact through shared values. Targets can be opened by multiple triggers, closed via classes or attributes, and respond to hover interactions. For more details, visit the Popover page.
Trigger
popover
|
|
popover-open
Open/Close on Click
Target Basic
popover-navigation
is-open
on-enter
on-exit
Tooltip text goes here.
Note: Close via popover-close class.
Target Overlay
popover-navigation
is-overlay
is-open
on-enter
on-exit
Tooltip text goes here.
Note: Close via popover-close class.
Target Basic
popover-navigation
is-open
on-enter
on-exit
Tooltip text goes here.
Note: Close via b-popover-close = tooltip-name attribute. This solution includes the interaction-based toggle button.
Open/Close on Hover
Target Basic
popover-navigation
is-open
on-enter
on-exit
Tooltip text goes here.
Note: Target element is hidden by default.
Target Overlay
popover-navigation
is-overlay
is-open
on-enter
on-exit
Tooltip text goes here.

Required Custom Behavior

Supporting custom behavior components required for this system to function correctly. These components are nested within
Global
so updates can be managed from one central location. Any edits made below will automatically apply across the site.
Custom Behavior -
Popover

Connect popover triggers and targets through matching attribute values using b-popover-open and b-popover-target. The system supports multiple triggers and targets sharing the same value, allowing coordinated popover behavior across the page. Opening and closing are controlled through the attributes b-popover-open and b-popover-close, as well as the class popover-close for local closing. Optional attributes such as b-popover-hover = true and b-popover-auto-close = # enable hover transitions and timed closing. Transition states are handled through the classes is-open, on-enter, and on-exit, ensuring smooth and predictable popover animations regardless of where the components are placed in the layout. View the full documentation for setup, structure, and usage details.

Tooltip Icon Color Styles

Defines color style variants for tooltip icons to ensure consistent visual alignment across themes and backgrounds.
Primary
Secondary
Tertiary
Alternate
Success
Info
Warning
Error