Components / Overlays
Tooltip
A popup that displays information related to an element on hover or focus.
Add to library
<button type="button" class="btn tooltip" data-variant="outline" data-tooltip="Add to library" data-arrow aria-describedby="demo-tooltip-default-description">
Hover
</button>
<span class="sr-only" id="demo-tooltip-default-description">Add to library</span>Installation
pnpm dlx loseta add tooltipnpx loseta add tooltipExamples
Sides
<div style="display: grid; grid-template-areas: '. top .' 'left . right' '. bottom .'; grid-template-columns: repeat(3, max-content); align-items: center; justify-items: center; gap: 1rem; padding-block: 2rem">
<button type="button" class="btn tooltip" data-variant="outline" data-size="sm" style="grid-area: top" data-tooltip="Top side" data-side="top" data-arrow id="demo-tooltip-side-top">
Top
</button>
<button type="button" class="btn tooltip" data-variant="outline" data-size="sm" style="grid-area: right" data-tooltip="Right side" data-side="right" data-arrow id="demo-tooltip-side-right">
Right
</button>
<button type="button" class="btn tooltip" data-variant="outline" data-size="sm" style="grid-area: bottom" data-tooltip="Bottom side" data-side="bottom" data-arrow id="demo-tooltip-side-bottom">
Bottom
</button>
<button type="button" class="btn tooltip" data-variant="outline" data-size="sm" style="grid-area: left" data-tooltip="Left side" data-side="left" data-arrow id="demo-tooltip-side-left">
Left
</button>
</div>Alignments
<div style="display: grid; gap: 2rem; justify-items: center; padding-block: 3.5rem 2.5rem">
<div style="display: flex; flex-wrap: wrap; justify-content: center; gap: 0.75rem">
<button type="button" class="btn tooltip" data-variant="outline" data-size="sm" data-tooltip="Align start" data-side="top" data-align="start" data-arrow id="demo-tooltip-align-top-start">
Start
</button>
<button type="button" class="btn tooltip" data-variant="outline" data-size="sm" data-tooltip="Align center" data-side="top" data-align="center" data-arrow id="demo-tooltip-align-top-center">
Center
</button>
<button type="button" class="btn tooltip" data-variant="outline" data-size="sm" data-tooltip="Align end" data-side="top" data-align="end" data-arrow id="demo-tooltip-align-top-end">
End
</button>
</div>
<div style="display: grid; gap: 0.75rem; justify-items: center">
<button type="button" class="btn tooltip" data-variant="outline" data-size="sm" data-tooltip="Align start" data-side="left" data-align="start" data-arrow id="demo-tooltip-align-left-start">
Start
</button>
<button type="button" class="btn tooltip" data-variant="outline" data-size="sm" data-tooltip="Align center" data-side="left" data-align="center" data-arrow id="demo-tooltip-align-left-center">
Center
</button>
<button type="button" class="btn tooltip" data-variant="outline" data-size="sm" data-tooltip="Align end" data-side="left" data-align="end" data-arrow id="demo-tooltip-align-left-end">
End
</button>
</div>
</div>Arrow
<div style="display: flex; flex-wrap: wrap; align-items: center; justify-content: center; gap: 0.75rem; padding-block: 2rem">
<button type="button" class="btn tooltip" data-variant="outline" data-size="sm" data-tooltip="Add to library" data-arrow id="demo-tooltip-with-arrow">
With arrow
</button>
<button type="button" class="btn tooltip" data-variant="outline" data-size="sm" data-tooltip="Add to library" id="demo-tooltip-without-arrow">
Without arrow
</button>
</div>Keyboard shortcut
<div style="display: flex; align-items: center; justify-content: center; padding-block: 2rem">
<button type="button" class="btn tooltip" data-variant="outline" data-size="icon" data-tooltip="Save changes (S)" data-arrow aria-label="Save changes" aria-keyshortcuts="S" id="demo-tooltip-keyboard">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M15.2 3a2 2 0 0 1 1.4.6l3.8 3.8a2 2 0 0 1 .6 1.4V19a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2z"/><path d="M17 21v-7a1 1 0 0 0-1-1H8a1 1 0 0 0-1 1v7"/><path d="M7 3v4a1 1 0 0 0 1 1h7"/></svg>
</button>
</div>Disabled button
This feature is currently unavailable
<div style="display: flex; align-items: center; justify-content: center; padding-block: 2rem">
<span class="tooltip" data-tooltip="This feature is currently unavailable" data-arrow style="display: inline-block">
<button type="button" class="btn" data-variant="outline" disabled aria-describedby="demo-tooltip-disabled-description">
Disabled
</button>
<span class="sr-only" id="demo-tooltip-disabled-description">This feature is currently unavailable</span>
</span>
</div>Long content
<div style="display: flex; align-items: center; justify-content: center; padding-block: 3rem">
<button type="button" class="btn tooltip" data-variant="outline" data-tooltip="Tooltips wrap onto multiple lines once the text is longer than the 20rem maximum width." data-arrow id="demo-tooltip-long-content">
Long content
</button>
</div>Right-to-left
<div dir="rtl" lang="ar" style="display: grid; gap: 2rem; justify-items: center; padding-block: 2.5rem">
<div style="display: flex; justify-content: center; gap: 0.75rem">
<button type="button" class="btn tooltip" data-variant="outline" data-size="sm" data-tooltip="إضافة" data-side="inline-start" data-arrow id="demo-tooltip-rtl-inline-start">
بداية السطر
</button>
<button type="button" class="btn tooltip" data-variant="outline" data-size="sm" data-tooltip="إضافة" data-side="inline-end" data-arrow id="demo-tooltip-rtl-inline-end">
نهاية السطر
</button>
</div>
<div style="display: flex; justify-content: center; gap: 0.75rem">
<button type="button" class="btn tooltip" data-variant="outline" data-size="sm" data-tooltip="إضافة" data-side="right" data-arrow id="demo-tooltip-rtl-right">
يمين
</button>
<button type="button" class="btn tooltip" data-variant="outline" data-size="sm" data-tooltip="إضافة" data-side="left" data-arrow id="demo-tooltip-rtl-left">
يسار
</button>
</div>
</div>Accessibility and behavior
- CSS-only: a .tooltip root with a data-tooltip text attribute, visible on hover and focus-visible. Text wraps at the 20rem maximum. Place the bubble with data-side (default top) and data-align (default center); add data-arrow for the pointer arrow. Keep an aria-label or aria-describedby on the trigger, because the generated bubble is not in the accessibility tree. Wrap a disabled control in .tooltip with display: inline-block; disabled controls stay pointer-only.
Files
components/tooltip.cssbasestyles/nova/tooltip.cssstyleInstall contract
The CLI writes the base file under components/, the visual file for the selected style under styles/<name>/, and any primitive dependency underprimitives/. The generated index.css imports them in the right layer order.