For AI agents: the complete documentation index is available at https://wallarm.github.io/design-system/llms.txt, the full documentation bundle is available at https://wallarm.github.io/design-system/llms-full.txt, and this page is available as Markdown at https://wallarm.github.io/design-system/components/popover.md.

Popover

A small panel anchored to what opened it, for content the reader can act on — a form, a set of controls, a detail with a link in it. Reach for Tooltip when the content is only a label, and Drawer when it is a task rather than a detail.

Source · Storybook

Usage

import { Alert, AlertContent, AlertControls, AlertDescription, AlertIcon, AlertTitle } from '@wallarm-org/design-system/Alert';
import { Button } from '@wallarm-org/design-system/Button';
import { Popover, PopoverContent, PopoverTrigger } from '@wallarm-org/design-system/Popover';
import { VStack } from '@wallarm-org/design-system/Stack';
import { Text } from '@wallarm-org/design-system/Text';

Examples

With tooltip

A tooltip on the popover's own trigger — the label explains what opens, the popover holds what you do.

Min max width

Width bounds, for content that varies. Let it size to the content rather than pinning it, or short content sits in an empty box.

Min max height

Height bounds with scrolling past the cap. If it scrolls often, the content has outgrown a popover.

Props

PropTypeDefaultDescription
openboolean | undefined
onOpenChange((open: boolean) => void) | undefined
idsElementIds | undefinedOverride the trigger element's id. Pass the same id to another compound component's ids.trigger (e.g. Tooltip, DropdownMenu) to compose their triggers on one element via nested asChild without an extra wrapper node — otherwise the outer trigger's id wins and the other component can't find its own anchor.
positioningPositioningOptions | undefinedCustom positioning configuration. When provided, overrides the default positioning.
data-testidstring | undefined

PopoverContent

PropTypeDefaultDescription
minHeightPopoverSizeDimension | undefined
maxHeightPopoverSizeDimension | undefinedPOPOVER_MAX_HEIGHT
minWidthPopoverSizeDimension | undefinedPOPOVER_MIN_WIDTH
maxWidthPopoverSizeDimension | undefinedPOPOVER_MAX_WIDTH
titlestring | undefined
defaultCheckedboolean | undefined
defaultValuestring | number | readonly string[] | undefined
autoFocusboolean | undefined
tabIndexnumber | undefined
relstring | undefined
onChangeChangeEventHandler<T, Element> | undefined
data-testidstring | undefined

PopoverTrigger

PropTypeDefaultDescription
asChildboolean | undefinedfalse
valuestring | undefinedA real <button>'s value DOM attribute is always a string at runtime.
titlestring | undefined
defaultCheckedboolean | undefined
defaultValuestring | number | readonly string[] | undefined
autoFocusboolean | undefined
idstring | undefined
tabIndexnumber | undefined
relstring | undefined
onChangeChangeEventHandler<T, Element> | undefined
type"button" | "submit" | "reset" | undefined
disabledboolean | undefined
namestring | undefined
data-testidstring | undefined

Explorer