Skip to content
loseta

Components / Overlays

Tooltip

A popup that displays information related to an element on hover or focus.

Status stableWorks with button
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 tooltip
npx loseta add tooltip

Examples

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.cssbase
styles/nova/tooltip.cssstyle

Install 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.

← Back to components

loseta is MIT licensed. Built with native CSS, no runtime. Inspired byshadcn/ui.