The tooltip component is used to provide additional information to the user when they hover over a specific element. It can be used to provide explanations, definitions, or supplementary information that is not critical to the main content.
Example
code
<div bp-layout="block center" style="height: 250px">
<bp-button-icon popovertarget="tooltip-example" id="tooltip-btn" action="flat" shape="info" aria-label="open tooltip"></bp-button-icon>
<bp-tooltip id="tooltip-example" anchor="tooltip-btn" trigger="tooltip-btn" position="top">hello there</bp-tooltip>
</div>
<script type="module">
import '@blueprintui/components/include/tooltip.js';
import '@blueprintui/components/include/button-icon.js';
import '@blueprintui/icons/shapes/info.js';
</script>
Position
tooltip righttooltip bottomtooltip lefttooltip top
code
<bp-tooltip open anchor="tooltip-action-1" trigger="tooltip-action-1" position="right">tooltip right</bp-tooltip>
<bp-tooltip open anchor="tooltip-action-2" trigger="tooltip-action-2" position="bottom">tooltip bottom</bp-tooltip>
<bp-tooltip open anchor="tooltip-action-3" trigger="tooltip-action-3" position="left">tooltip left</bp-tooltip>
<bp-tooltip open anchor="tooltip-action-4" trigger="tooltip-action-4" position="top">tooltip top</bp-tooltip>
<div bp-layout="grid gap:md cols:6 block:stretch center" style="padding-top: 100px; max-height: 95vh; min-height: 340px">
<bp-button-icon id="tooltip-action-1" action="flat" shape="info" aria-label="open tooltip"></bp-button-icon>
<bp-button-icon id="tooltip-action-3" action="flat" shape="info" aria-label="open tooltip"></bp-button-icon>
<bp-button-icon id="tooltip-action-2" action="flat" shape="info" aria-label="open tooltip"></bp-button-icon>
<bp-button-icon id="tooltip-action-4" action="flat" shape="info" aria-label="open tooltip"></bp-button-icon>
</div>
<script type="module">
import '@blueprintui/components/include/tooltip.js';
import '@blueprintui/components/include/button-icon.js';
import '@blueprintui/icons/shapes/info.js';
</script>
Install
NPM
import '@blueprintui/components/include/tooltip.js';
CDN
<script type="module">
import 'https://cdn.jsdelivr.net/npm/@blueprintui/components/include/tooltip.js/+esm';
</script>
Accessibility
- The component should be fully navigable using only the keyboard, allowing users to easily move between different tooltips.
- The component should also provide a clear visual indication of focus for keyboard only users.
Events
Name | Types | Description |
---|
open |
| dispatched when the tooltip is opened |
close |
| dispatched when the tooltip is closed |
Properties
Name | Types | Description |
---|
accessor |
| set default aria/i18n strings |
closable | boolean | |
open | boolean | |
position | Position | |
anchor | HTMLElement | string | |
trigger | HTMLElement | string | |
i18n |
| |
Attributes
Name | Types | Description |
---|
accessor |
| set default aria/i18n strings |
CSS Properties
Name | Types | Description |
---|
--padding |
| |
--filter |
| |
--background |
| |
--color |
| |
--width |
| |
--height |
| |
--min-width |
| |
--min-height |
| |
--font-size |
| |
Slots
Name | Types | Description |
---|
default |
| content |