Popover

Popover wraps Radix primitives with Brandit styles and ships a composed API: Popover, PopoverTrigger, PopoverContent, and PopoverAnchor.

When to use

• Display contextual controls or forms without leaving the page.
• Build dropdown menus, mini cart previews, or filter panels.
• Show richer content than a tooltip when a click interaction is appropriate.

Behavior notes

• Use PopoverTrigger with asChild to wrap existing interactive elements.
• PopoverContent renders in a portal with border, shadow, and animation.
• Use the align prop (start, center, end) to control horizontal alignment.
• Use PopoverAnchor for custom positioning relative to a non-trigger element.

Example

<Popover>
  <PopoverTrigger asChild>
    <Button variant='outline' size='sm'>
      Open popover
    </Button>
  </PopoverTrigger>
  <PopoverContent align='end'>
    <p>Popover content goes here.</p>
  </PopoverContent>
</Popover>

Preview

Usage

import { Button, Popover, PopoverContent, PopoverTrigger } from '@branditdev/ui';

export function PopoverDemo() {
  return (
    <div className='flex flex-wrap items-center gap-3'>
      <Popover>
        <PopoverTrigger render={<Button variant='outline' size='sm' />}>
          Open popover
        </PopoverTrigger>
        <PopoverContent>
          <div className='grid gap-2'>
            <h4 className='font-medium leading-none'>Dimensions</h4>
            <p className='text-sm text-muted-foreground'>
              Set the dimensions for the layer.
            </p>
          </div>
        </PopoverContent>
      </Popover>
    </div>
  );
}

API

Popover(props): Element

Defined in: components/popover/popover.tsx:14

Popover root for trigger/content composition.

Parameters

Returns

Element

A popover root wrapper.

Source

'use client';

import { Popover as PopoverPrimitive } from '@base-ui/react/popover';
import * as React from 'react';

import { cn } from '@branditdev/ui';

function Popover({ ...props }: PopoverPrimitive.Root.Props) {
  return <PopoverPrimitive.Root data-slot='popover' {...props} />;
}

function PopoverTrigger({ ...props }: PopoverPrimitive.Trigger.Props) {
  return <PopoverPrimitive.Trigger data-slot='popover-trigger' {...props} />;
}

function PopoverContent({
  className,
  align = 'center',
  alignOffset = 0,
  side = 'bottom',
  sideOffset = 4,
  ...props
}: PopoverPrimitive.Popup.Props &
  Pick<
    PopoverPrimitive.Positioner.Props,
    'align' | 'alignOffset' | 'side' | 'sideOffset'
  >) {
  return (
    <PopoverPrimitive.Portal>
      <PopoverPrimitive.Positioner
        align={align}
        alignOffset={alignOffset}
        side={side}
        sideOffset={sideOffset}
        className='isolate z-50'
      >
        <PopoverPrimitive.Popup
          data-slot='popover-content'
          className={cn(
            'bg-popover text-popover-foreground data-open:animate-in data-closed:animate-out data-closed:fade-out-0 data-open:fade-in-0 data-closed:zoom-out-95 data-open:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 ring-foreground/10 flex flex-col gap-2.5 rounded-lg p-2.5 text-sm shadow-md ring-1 duration-100 data-[side=inline-start]:slide-in-from-right-2 data-[side=inline-end]:slide-in-from-left-2 z-50 w-72 origin-(--transform-origin) outline-hidden',
            className
          )}
          {...props}
        />
      </PopoverPrimitive.Positioner>
    </PopoverPrimitive.Portal>
  );
}

function PopoverHeader({ className, ...props }: React.ComponentProps<'div'>) {
  return (
    <div
      data-slot='popover-header'
      className={cn('flex flex-col gap-0.5 text-sm', className)}
      {...props}
    />
  );
}

function PopoverTitle({ className, ...props }: PopoverPrimitive.Title.Props) {
  return (
    <PopoverPrimitive.Title
      data-slot='popover-title'
      className={cn('font-medium', className)}
      {...props}
    />
  );
}

function PopoverDescription({
  className,
  ...props
}: PopoverPrimitive.Description.Props) {
  return (
    <PopoverPrimitive.Description
      data-slot='popover-description'
      className={cn('text-muted-foreground', className)}
      {...props}
    />
  );
}

export {
  Popover,
  PopoverContent,
  PopoverDescription,
  PopoverHeader,
  PopoverTitle,
  PopoverTrigger,
};