mirror of
https://github.com/tabler/tabler.git
synced 2026-08-30 22:01:28 +04:00
37 lines
2.1 KiB
Plaintext
37 lines
2.1 KiB
Plaintext
---
|
|
title: Tooltip
|
|
summary: A tooltip is a text label that appears when a user hovers over an interface element. It explains unclear elements and guides users when they need help. When used properly, it can significantly enhance user experience and add value to your website or software.
|
|
description: Explain interface elements with tooltips shown on hover. Control placement, add HTML content, and customize how they appear.
|
|
related: [/ui/components/popover]
|
|
---
|
|
import Example from '@components/Example.astro';
|
|
import CodeDocs from '@components/CodeDocs.astro';
|
|
|
|
## Default markup
|
|
|
|
Use the default markup to create tooltips that will help users understand particular elements of your interface. You can decide where the text label is to be displayed - at the top, bottom or on either side of the element.
|
|
|
|
<Example>
|
|
<div class="btn-list"> <button type="button" class="btn" data-bs-toggle="tooltip" data-bs-placement="top" title="Tooltip on top" > Tooltip on top </button> <button type="button" class="btn" data-bs-toggle="tooltip" data-bs-placement="right" title="Tooltip on right" > Tooltip on right </button> <button type="button" class="btn" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Tooltip on bottom" > Tooltip on bottom </button> <button type="button" class="btn" data-bs-toggle="tooltip" data-bs-placement="left" title="Tooltip on left" > Tooltip on left </button> </div>
|
|
</Example>
|
|
|
|
## Tooltip with HTML
|
|
|
|
If the default tooltip is not enough, you can add the option to use HTML code in the text to highlight particular bits of information and make the content more attractive.
|
|
|
|
<Example>
|
|
<button type="button" class="btn" data-bs-toggle="tooltip" data-bs-html="true" title="<em>Tooltip</em> <u>with</u> <b>HTML</b>" > Tooltip with HTML </button>
|
|
</Example>
|
|
|
|
## JavaScript
|
|
|
|
Tabler automatically initializes all elements with `data-bs-toggle="tooltip"` on page load. This is the code that runs:
|
|
|
|
<CodeDocs name="tooltip-init" file="core/js/src/tooltip.ts" />
|
|
|
|
## SCSS variables
|
|
|
|
Use these SCSS variables to customize tooltips. The default values are:
|
|
|
|
<CodeDocs name="tooltip-variables" file="core/scss/_variables.scss" />
|