Popover

Floating content container triggered by user interaction. Supports rich content, focus management, and dismissal.

Options

Placement

Top
Bottom
Left
Right

Arrow

Arrow
No arrow

Table of options

PropertyValuesDefault
placementtop / bottom / left / rightbottom
arrowboolean attributefalse

Behaviors

Toggle on trigger click

The popover opens when the trigger button is clicked and closes when clicked again, when the user clicks outside, or when Escape is pressed.

Usage guidelines

Do

Use popovers for rich content, interactive controls, or detailed information triggered by a user action.

Don't

Don't use popovers for simple one-line labels. Use a tooltip instead.

Accessibility

  • Uses role="dialog" on the popover panel.
  • The trigger button has aria-expanded and aria-controls linking it to the panel.
  • Focus moves into the popover on open and returns to the trigger on close.
  • Escape closes the popover from anywhere inside it.
  • Tab focus is trapped within the open popover.

Design checklist

All brand/mode contextsWorks across light and dark modes.
Defined optionsPlacement, arrow documented.
Usage guidelinesDo/don't for content type.
Design tokensComponent-scoped tokens (--uif-popover-*).