Community project. This is not an official government website.

Run by volunteers. Lampung Design System is built by an open source community. No government agency runs or endorses it.

Official services use go.id. Government websites in Indonesia end in .go.id. Never enter your national ID number on a site you are unsure of.

Popover

Popover

A small floating card anchored to a button, for content richer than a menu: a mini form, a short explanation with a link, a quick setting. It does not block the page.

Usage

Use it when

  • A few fields or controls tied to one button: set a reminder, adjust a column width, quick-edit a due date.
  • A short explanation people open on purpose, with formatting or a link inside.

Use something else when

  • A list of commands: use Dropdown menu.
  • A label for an icon or a one-line hint on hover: use Tooltip.
  • A preview of a person or link on hover: use Hover card.
  • A task that needs focus and a decision before going on: use Dialog.
  • Picking a date: use Date field. The date field already pairs a control with its calendar popover.

Where it goes. 8 px below its trigger, aligned to its left edge, 300 px wide. Trigger and popover share a position: relative wrapper; position the popover with inline top/left. On phones, use a sheet for anything with fields.

Examples

Set a reminderThe popover toggles from its button, grows from the top and closes on Escape or a click outside.
<div style="position: relative;">
  <button class="btn btn--secondary" aria-haspopup="dialog" aria-expanded="false" aria-controls="remind" data-lds-menu="remind">Remind me</button>
  <div class="popover" id="remind" role="dialog" aria-labelledby="remind-t" style="top: calc(100% + 8px); left: 0;">
    <h3 class="section__title-sm" id="remind-t">Remind me about Lab report 3</h3>
    …
  </div>
</div>
Static, openA popover explaining a score, shown open.
<div style="position: relative; align-self: flex-start;">
  <button class="btn btn--plain btn--sm" aria-haspopup="dialog" aria-expanded="true" aria-controls="po-score">How is this scored?</button>
  <div class="popover is-open" id="po-score" role="dialog" aria-label="How the score works" style="top: calc(100% + 8px); left: 0;">
    <p class="section__sub">Each correct answer is worth 5 points, a wrong one 0. Unanswered questions do not count against you.</p>
  </div>
</div>

Anatomy

PartWhat it is
triggerRequired. A button with aria-haspopup="dialog", aria-expanded and aria-controls the popover id.
.popoverRequired. The floating card: 300 px, 16 px padding, elevated with a shadow; role="dialog" and aria-label (or aria-labelledby).
.popover.is-openRequired to show it.

States

StateHow
.is-openVisible and interactive; the trigger has aria-expanded="true".
closedTransparent, slightly scaled, visibility: hidden after the exit.

Motion and microinteractions

  • Enter: opacity over --d-fast (160 ms) on --ease-enter; from scale(0.96) translateY(-4px) on --spring-smooth, growing from top center.
  • Exit: over --d-exit (180 ms) on --ease-exit, then hidden. A transition, so a quick toggle reverses smoothly.
  • Reduced motion: fade only.

Accessibility

  • Non-modal: focus is not trapped, the page stays usable. Give it role="dialog" and a name.
  • Moving focus into it on open and back to the trigger on close is your job, unless you reuse the menu hook (which focuses its first button, closes on Escape and returns focus).
  • Escape and a click outside close it.

Do and don't

Do

  • Keep it to one small task or explanation.
  • Close it after the main action.

Don't

  • Put a long form or a table in a popover.
  • Open it on hover; that is a hover card.
  • Use a popover where a dropdown menu of commands would do.

Behavior and code

Plain HTML. No dedicated hook: toggle .is-open and aria-expanded yourself, or reuse the menu hook (data-lds-menu="popoverId" on the trigger), which opens and closes it, focuses its first button, closes on Escape (focus back to the trigger) and on a click outside; call closeMenus() after the action inside the popover. Avoid controls that use Up and Down arrows inside it: those keys are handled as menu keys.