v0.17.1

Appearance

Tooltip <l-tooltip> ​

Tooltips are used to display a short text label on hover or focus to describe an element. Commonly used on icon buttons, truncated text, and controls that need additional context.

HTML tag<l-tooltip>
⏣Native
⬡Progressive
◇Plain
⬢Shadow-DOM
Shadow-DOM Custom Element

Options ​

Basic ​

Reference a trigger element by ID using the for attribute.

Save changes
Code
html
<button
  id="tooltip-basic"
  class="l-button"
>
  Hover me
</button>
<l-tooltip for="tooltip-basic">Save changes</l-tooltip>

Placement ​

Set placement to control position: top (default), bottom, left, right.

Top Bottom Left Right
Code
html
<div class="flex flex-wrap items-center gap-4">
  <button
    id="tooltip-top"
    class="l-button"
  >
    Top
  </button>
  <l-tooltip
    for="tooltip-top"
    placement="top"
    >Top</l-tooltip
  >

  <button
    id="tooltip-bottom"
    class="l-button"
  >
    Bottom
  </button>
  <l-tooltip
    for="tooltip-bottom"
    placement="bottom"
    >Bottom</l-tooltip
  >

  <button
    id="tooltip-left"
    class="l-button"
  >
    Left
  </button>
  <l-tooltip
    for="tooltip-left"
    placement="left"
    >Left</l-tooltip
  >

  <button
    id="tooltip-right"
    class="l-button"
  >
    Right
  </button>
  <l-tooltip
    for="tooltip-right"
    placement="right"
    >Right</l-tooltip
  >
</div>

Trigger ​

Set trigger to control activation: hover focus (default), click, hover, focus, manual.

At most one hover/focus/click tooltip is visible at a time — opening one dismisses the previous. manual tooltips opt out: several can stay open together and are never dismissed by other tooltips.

Click-triggered tooltip
Code
html
<button
  id="tooltip-click"
  class="l-button"
>
  Click me
</button>
<l-tooltip
  for="tooltip-click"
  trigger="click"
  >Click-triggered tooltip</l-tooltip
>

Delay ​

Set show-delay to require the pointer to dwell before the tooltip shows — filtering out tooltips for controls the pointer merely passes over (toolbars, table action columns, dense grids). Set hide-delay to bridge a brief exit-and-return without flicker. Both are in milliseconds and apply to hover only; focus always shows immediately.

Shows right away Only after the pointer rests
Code
html
<div class="flex gap-3">
  <button
    id="tooltip-delay-a"
    class="l-button"
  >
    Immediate
  </button>
  <l-tooltip for="tooltip-delay-a">Shows right away</l-tooltip>

  <button
    id="tooltip-delay-b"
    class="l-button"
  >
    Dwell 400ms
  </button>
  <l-tooltip
    for="tooltip-delay-b"
    show-delay="400"
    hide-delay="150"
    >Only after the pointer rests</l-tooltip
  >
</div>

Without arrow ​

Add without-arrow to hide the directional arrow.

No arrow tooltip
Code
html
<button
  id="tooltip-no-arrow"
  class="l-button"
>
  Hover me
</button>
<l-tooltip
  for="tooltip-no-arrow"
  without-arrow
  >No arrow tooltip</l-tooltip
>

Custom color ​

Set --background-color to a base color. Text color is auto-derived from its luminance for readable contrast.

Auto-derived text color Auto-derived text color Auto-derived text color
Code
html
<div class="flex flex-wrap items-center gap-3">
  <button
    id="tooltip-color-yellow"
    class="l-button"
  >
    Yellow
  </button>
  <l-tooltip
    for="tooltip-color-yellow"
    style="--background-color: oklch(90.5% 0.182 98.111)"
  >
    Auto-derived text color
  </l-tooltip>

  <button
    id="tooltip-color-pink"
    class="l-button"
  >
    Pink
  </button>
  <l-tooltip
    for="tooltip-color-pink"
    style="--background-color: oklch(82.3% 0.12 346.018)"
  >
    Auto-derived text color
  </l-tooltip>

  <button
    id="tooltip-color-indigo"
    class="l-button"
  >
    Indigo
  </button>
  <l-tooltip
    for="tooltip-color-indigo"
    style="--background-color: oklch(45.7% 0.24 277.023)"
  >
    Auto-derived text color
  </l-tooltip>
</div>

Examples ​

Icon toolbar ​

Give each icon button its own tooltip and a show-delay so sweeping across the group doesn't flash a tooltip on every control the pointer passes over — only the one the pointer rests on opens. Keep an aria-label on each button: the tooltip supplements the accessible name, it doesn't replace it.

Bold Italic Underline Insert link
Code
html
<l-button-group label="Text formatting">
  <button
    id="tooltip-tb-bold"
    class="l-button"
    aria-label="Bold"
  >
    <iconify-icon icon="lucide:bold"></iconify-icon>
  </button>
  <button
    id="tooltip-tb-italic"
    class="l-button"
    aria-label="Italic"
  >
    <iconify-icon icon="lucide:italic"></iconify-icon>
  </button>
  <button
    id="tooltip-tb-underline"
    class="l-button"
    aria-label="Underline"
  >
    <iconify-icon icon="lucide:underline"></iconify-icon>
  </button>
  <button
    id="tooltip-tb-link"
    class="l-button"
    aria-label="Insert link"
  >
    <iconify-icon icon="lucide:link"></iconify-icon>
  </button>
</l-button-group>

<l-tooltip
  for="tooltip-tb-bold"
  show-delay="400"
  >Bold</l-tooltip
>
<l-tooltip
  for="tooltip-tb-italic"
  show-delay="400"
  >Italic</l-tooltip
>
<l-tooltip
  for="tooltip-tb-underline"
  show-delay="400"
  >Underline</l-tooltip
>
<l-tooltip
  for="tooltip-tb-link"
  show-delay="400"
  >Insert link</l-tooltip
>

All placements ​

All 12 placement options with aligned variants (-start, -end).

top-start top top-end bottom-start bottom bottom-end left-start left left-end right-start right right-end
Code
html
<div class="relative mx-auto h-80 w-80">
  <button
    id="p-top-start"
    class="l-button absolute"
    style="left: calc(50% - 70px - 1rem); top: 0"
    aria-label="top-start"
  >
    &#9632;
  </button>
  <l-tooltip
    for="p-top-start"
    placement="top-start"
    >top-start</l-tooltip
  >

  <button
    id="p-top"
    class="l-button absolute"
    style="left: calc(50% - 10px - 1rem); top: 0"
    aria-label="top"
  >
    &#9632;
  </button>
  <l-tooltip
    for="p-top"
    placement="top"
    >top</l-tooltip
  >

  <button
    id="p-top-end"
    class="l-button absolute"
    style="left: calc(50% + 50px - 1rem); top: 0"
    aria-label="top-end"
  >
    &#9632;
  </button>
  <l-tooltip
    for="p-top-end"
    placement="top-end"
    >top-end</l-tooltip
  >

  <button
    id="p-bottom-start"
    class="l-button absolute"
    style="left: calc(50% - 70px - 1rem); bottom: 0"
    aria-label="bottom-start"
  >
    &#9632;
  </button>
  <l-tooltip
    for="p-bottom-start"
    placement="bottom-start"
    >bottom-start</l-tooltip
  >

  <button
    id="p-bottom"
    class="l-button absolute"
    style="left: calc(50% - 10px - 1rem); bottom: 0"
    aria-label="bottom"
  >
    &#9632;
  </button>
  <l-tooltip
    for="p-bottom"
    placement="bottom"
    >bottom</l-tooltip
  >

  <button
    id="p-bottom-end"
    class="l-button absolute"
    style="left: calc(50% + 50px - 1rem); bottom: 0"
    aria-label="bottom-end"
  >
    &#9632;
  </button>
  <l-tooltip
    for="p-bottom-end"
    placement="bottom-end"
    >bottom-end</l-tooltip
  >

  <button
    id="p-left-start"
    class="l-button absolute"
    style="top: calc(50% - 70px - 1rem); left: 0"
    aria-label="left-start"
  >
    &#9632;
  </button>
  <l-tooltip
    for="p-left-start"
    placement="left-start"
    >left-start</l-tooltip
  >

  <button
    id="p-left"
    class="l-button absolute"
    style="top: calc(50% - 10px - 1rem); left: 0"
    aria-label="left"
  >
    &#9632;
  </button>
  <l-tooltip
    for="p-left"
    placement="left"
    >left</l-tooltip
  >

  <button
    id="p-left-end"
    class="l-button absolute"
    style="top: calc(50% + 50px - 1rem); left: 0"
    aria-label="left-end"
  >
    &#9632;
  </button>
  <l-tooltip
    for="p-left-end"
    placement="left-end"
    >left-end</l-tooltip
  >

  <button
    id="p-right-start"
    class="l-button absolute"
    style="top: calc(50% - 70px - 1rem); right: 0"
    aria-label="right-start"
  >
    &#9632;
  </button>
  <l-tooltip
    for="p-right-start"
    placement="right-start"
    >right-start</l-tooltip
  >

  <button
    id="p-right"
    class="l-button absolute"
    style="top: calc(50% - 10px - 1rem); right: 0"
    aria-label="right"
  >
    &#9632;
  </button>
  <l-tooltip
    for="p-right"
    placement="right"
    >right</l-tooltip
  >

  <button
    id="p-right-end"
    class="l-button absolute"
    style="top: calc(50% + 50px - 1rem); right: 0"
    aria-label="right-end"
  >
    &#9632;
  </button>
  <l-tooltip
    for="p-right-end"
    placement="right-end"
    >right-end</l-tooltip
  >
</div>

Accessibility ​

Criteria ​

Role

Popover has role="tooltip" with a generated id

WCAG4.1.2
RGAA7.1
Accessible description

Trigger receives aria-describedby pointing to the tooltip when open

WCAG4.1.2
RGAA11.1
Hover state

Shows on pointerenter; safe polygon hover bridge prevents flickering

WCAG1.4.13
Focus state

Shows on focusin, hides on focusout

WCAG1.4.132.4.7
Dismissible

Closes on Escape without moving focus

WCAG1.4.13
Motion

Respects prefers-reduced-motion

WCAG2.3.3

Keyboard interactions ​

Escape
Dismisses the tooltip without moving focus
Tab
Moving focus to the trigger shows the tooltip; moving away hides it

API reference ​

Importing ​

js
import 'luxen-ui/tooltip';

Attributes & Properties ​

forstringProperty
The HTML id of the element triggering the tooltip.
placementPlacementdefault:'top'Property
The preferred placement of the tooltip.
distancenumberdefault:8Property
The distance in pixels from the target element.
show-delaynumberdefault:0Property
Milliseconds the pointer must dwell on the trigger before the tooltip shows. Applies to hover only — focus shows immediately.
hide-delaynumberdefault:0Property
Milliseconds to wait after the pointer leaves the trigger (and its safe polygon) before hiding. Bridges a brief exit-and-return without flicker. Applies to hover only.
openbooleandefault:falseProperty
Whether or not the tooltip is visible.
without-arrowbooleandefault:falseProperty
Hide the directional arrow.
triggerstringdefault:'hover focus'Property
Space-separated list of trigger modes: hover, focus, click, manual.

Methods ​

show()Method
hide()Method
toggle()Method

CSS custom properties ​

--background-colorCustom property
Background color for this tooltip instance. Defaults to the global --l-tooltip-background-color token (a neutral inverse surface, dark in light mode / light in dark mode) — override that token to re-skin every tooltip at once.
--text-colorCustom property
Text color. If unset, auto-derived from --background-color luminance.
--border-radiusdefault:4pxCustom property
Border radius.
--max-widthdefault:180pxCustom property
Maximum width.
--arrow-sizedefault:6pxCustom property
Arrow size.
--show-durationdefault:150msCustom property
Show animation duration.
--hide-durationdefault:150msCustom property
Hide animation duration.