Light themes
Dark themes

Make your own

Popover

A popover is a small panel that opens beside the button that asked for it, for a few controls or a short explanation.

Share this note

Anyone with the link can read it.

Batch

Everything packed from one collection. The autumn batch was 412 jars.

Markup

HTML
<span class="tray-anchor" data-tray="popover">
  <button class="tray-btn tray-btn--quiet tray-btn--sm" type="button">Share</button>
  <div class="tray-pop tray-pop--card">
    <p class="tray-pop__title">Share this note</p>
    <p class="tray-pop__text">Anyone with the link can read it.</p>
    …
  </div>
</span>

The panel is raised with the float shadow. tray-pop alone is a tight list panel (20px corners, used by menus); add tray-pop--card for a 22rem panel with 28px corners and room for text, or tray-pop--roomy to keep the natural width. Placement: under the trigger from its start edge; tray-pop--end aligns it to the end edge, tray-pop--top opens it upward.

Popover, Tooltip or Dialog

A Tooltip is one line that names a control and cannot be interacted with. A popover holds controls or a paragraph and does not block the page. A Dialog blocks the page until answered.

Accessibility

It opens on click and moves focus to the first control inside. A panel of text alone has no control to take focus, so it takes focus itself: the behaviour makes it a dialog named by its tray-pop__title (or by the trigger) and described by its tray-pop__text, so the explanation is read as it opens. Escape or a data-close button closes it and puts focus back on the trigger, and a click outside or Tab out closes it too. The trigger reports aria-expanded and points at the panel with aria-controls. A panel with controls has no role or name of its own, so its title is read only as text: give each control inside its own name, and an icon-only trigger an aria-label ("What is a batch?"). Under prefers-reduced-motion: reduce the panel only fades, in a tenth of a second.

Do and don't

  • Do keep it to one small job: share, pick a colour, explain a term.
  • Do give it a title when it has more than two controls.
  • Don't open one on hover; for hover, see Hover Card.
  • Don't put a form with validation in a popover.
↑↓ to moveEnter to openEsc to close