Components Overlays

Tooltip

Explain a compact label when a reader hovers, focuses, or taps its trigger.

Live previewGo + JavaScript
Artwork that extends past the trim line.

Usage

Use a short Label and Description. Hover and keyboard focus reveal the hint; Escape dismisses it. The button toggles a persistent hint for touch users. Keep actionable content in a popover.

Register tooltip with Head and pass its properties to Render. Go setup guide

Go usage
Go usage
err := mono.UI.Render(w, "tooltip", mono.Props{
	"Description": "Artwork that extends past the trim line.",
	"Label":       "Bleed",
})
Rendered HTML
Rendered HTML
<span id="demo-tooltip" data-mono="tooltip">
  <button type="button" class="mu-btn mu-ghost" aria-describedby="demo-tooltip-hint">Bleed</button>
  <span id="demo-tooltip-hint" role="tooltip">Artwork that extends past the trim line.</span>
</span>
Go template
Go template
<span id="{{.ID}}" data-mono="tooltip">
  <button type="button" class="mu-btn mu-ghost" aria-describedby="{{.ID}}-hint">{{.Label}}</button>
  <span id="{{.ID}}-hint" role="tooltip">{{.Description}}</span>
</span>
Component CSS
Component CSS
[data-mono="tooltip"] { display: inline-flex; position: relative; }
[data-mono="tooltip"] [role="tooltip"] { position: absolute; z-index: 2; bottom: 100%; left: 0; width: max-content; max-width: min(17rem, 72vw); background: #181818; border-radius: .35rem; color: white; padding: .55rem .7rem; font-size: .82rem; visibility: hidden; }
[data-mono="tooltip"]:not([data-dismissed]):is(:hover, :focus-within, [data-pinned]) [role="tooltip"] { visibility: visible; }
JavaScript module
JavaScript module
export function mount(root) {
  const trigger = root.querySelector('button');
  let pinned = false;
  let hovered = false;

  function dismiss(event) {
    if (event.key !== 'Escape') return;
    pinned = false;
    delete root.dataset.pinned;
    root.dataset.dismissed = '';
    document.removeEventListener('keydown', dismiss);
  }
  function show() {
    delete root.dataset.dismissed;
    document.addEventListener('keydown', dismiss);
  }
  function release() {
    if (!pinned && !hovered && !root.contains(document.activeElement)) {
      document.removeEventListener('keydown', dismiss);
      delete root.dataset.dismissed;
    }
  }
  root.addEventListener('pointerenter', event => {
    if (event.pointerType === 'touch') return;
    hovered = true;
    show();
  });
  root.addEventListener('pointerleave', () => { hovered = false; release(); });
  trigger.addEventListener('focus', show);
  trigger.addEventListener('blur', () => {
    pinned = false;
    delete root.dataset.pinned;
    if (!hovered) document.removeEventListener('keydown', dismiss);
  });
  trigger.addEventListener('click', () => {
    pinned = !pinned;
    root.toggleAttribute('data-pinned', pinned);
    if (pinned) show();
    else root.dataset.dismissed = '';
  });
}
Use the HTML in a static site

Copy the rendered HTML above. Download these assets into the same folder as your page, then add the tags below to its head.

Shared CSS Component CSS Ready-to-use module

HTML head
<link rel="stylesheet" href="./base.css">
<link rel="stylesheet" href="./tooltip.css">
<script type="module" src="./tooltip.js"></script>

Copy into your project

Run this command from the Mono checkout. Set -out to the component directory in your application.

Terminal
go run ./cmd/mono-ui add -out ./components tooltip
Example properties (JSON)
example.json
{
  "Description": "Artwork that extends past the trim line.",
  "Label": "Bleed"
}