Popover

A floating surface for rich content anchored to a trigger.

Default

A floating surface anchored to a trigger that opens on click. PopoverHeader stacks a title and a description.

With fields

Hold a short edit next to the thing it changes. Control open to close the popover from its own actions.

Side

Bottom is the default. The popover flips to the opposite side when there is no room.

Align

Center is the default. Pass start or end to line the popover up with an edge of the trigger.

Best practices

When to use

  • Use for lightweight contextual content or a short edit anchored to a trigger that opens on click: usage details, rename a view.
  • Use Dialog or Drawer when the content is task-critical, long or needs a persistent footer. Use Hover Card for hover previews and Tooltip for a short label.

Behavior

  • Bottom and center are the defaults (side, align); the popover flips when there is no room. Change side only when the default covers related content.
  • Control open when the popover's own buttons (Save, Cancel) should close it.

Content

  • Lead with PopoverHeader (PopoverTitle + PopoverDescription). Use at most one or two fields and size="sm" buttons.

Accessibility

  • Popover opens on click and keyboard, never on hover only, so it can hold focusable fields. Do not put the only explanation for a required action in it.