Components
Popover
Popovers display floating content anchored to a trigger element. Use them for non-modal contextual information or actions.
Anatomy
Anatomy
import {Popover} from '@staffbase/design';
<Popover.Root>
<Popover.Trigger />
<Popover.Content>
<Popover.Close />
</Popover.Content>
</Popover.Root>; API reference
Root
Inherits props fromRadix UI Popover Root
Trigger
Inherits props fromRadix UI Popover Trigger
| Name | Type | Description |
|---|---|---|
children | ReactNode | The element that toggles the popover when activated. Passed as a single element, not via a render prop. |
Content
Inherits props fromRadix UI Popover Content
| Name | Type | Description |
|---|---|---|
children | ReactNode | The content shown inside the popover. |
side | toprightbottomleft | Which side of the trigger (or anchor) to position the popover against. Default: bottom |
align | startcenterend | The alignment of the popover against the trigger (or anchor). Default: center |
sideOffset | number | The distance in pixels between the popover and its trigger (or anchor). Default: 4 |
container | HTMLElementRefObject<HTMLElement> | The element the popover portal renders into. Use this instead of z-index to control stacking. Defaults to the document body. |
Close
Inherits props fromRadix UI Popover Close
| Name | Type | Description |
|---|---|---|
title | string | An accessible label for the close button, surfaced to assistive technology and as a tooltip. |
Anchor
Inherits props fromRadix UI Popover Anchor
Anatomy



Properties
Trigger Element

Position

Behaviour
Interaction
- Close when clicking the trigger again or when clicking outside the popover.
- Keep the triggering button in a pressed state while the popover is open.
- Close when pointer focus leaves both trigger and popover.

Best Practices

Don’t use Popover when not necessary. Hiding content can be counterproductive and there are accessible alternatives.

Do: Show content as description text. It improves clarity and is easier to navigate for assistive technology.

Match button height with line-height. Align the help button to the text baseline for visual balance.

Use icons consistently. Icon-only help uses question mark, while icon plus text uses info icon.
Usage Examples
Help Button

Custom Content

Content Guidelines
Unlabelled Icons or UI Elements
- Device types
- Copy, edit, or delete functions
- Pill labels (see Pill component guidance in this design system)