Popover

A React popover on Base UI for small menus, inline forms, and rich previews, with collision aware placement, a custom anchor, and four set widths.

Loading preview

Examples

Practical examples and common states for the same installable component.

Default

Simple informational popover anchored to a trigger.

examples/popover-default.tsx
import { Popover, PopoverContent, PopoverTrigger } from "@/components/wensity/popover";
export function DefaultPopover() {
return (
<Popover>
<PopoverTrigger>Info</PopoverTrigger>
<PopoverContent>Helpful context about this control.</PopoverContent>
</Popover>
);
}

Form

Inline edit fields without opening a full modal.

examples/popover-form.tsx
import { Popover, PopoverContent, PopoverTrigger } from "@/components/wensity/popover";
export function FormPopover() {
return (
<Popover>
<PopoverTrigger>Edit</PopoverTrigger>
<PopoverContent variant="form">{/* fields */}</PopoverContent>
</Popover>
);
}

Menu

Compact action list with separators and destructive items.

examples/popover-menu.tsx
import { Popover, PopoverContent, PopoverMenuItem, PopoverTrigger } from "@/components/wensity/popover";
export function MenuPopover() {
return (
<Popover>
<PopoverTrigger>•••</PopoverTrigger>
<PopoverContent variant="menu">
<PopoverMenuItem>Edit</PopoverMenuItem>
</PopoverContent>
</Popover>
);
}

Rich content

Media header with structured title and description.

examples/popover-rich.tsx
import { Popover, PopoverContent, PopoverRichMedia, PopoverTrigger } from "@/components/wensity/popover";
export function RichPopover() {
return (
<Popover>
<PopoverTrigger>Preview</PopoverTrigger>
<PopoverContent variant="rich">
<PopoverRichMedia src="/preview.webp" alt="Preview" />
</PopoverContent>
</Popover>
);
}

Controlled

External state owns the open/close lifecycle.

examples/popover-controlled.tsx
"use client";
import { useState } from "react";
import { Popover, PopoverContent, PopoverTrigger } from "@/components/wensity/popover";
export function ControlledPopover() {
const [open, setOpen] = useState(false);
return (
<Popover open={open} onOpenChange={setOpen}>
<PopoverTrigger>Anchor</PopoverTrigger>
<PopoverContent>Controlled content</PopoverContent>
</Popover>
);
}

Overview

Popover is a React and Tailwind CSS popover on Base UI, in Next.js or any React app, for small menus, inline forms, and rich previews that open on click. PopoverContent takes a side, an alignment, and an offset, and keeps 12 pixels from the viewport edge by flipping or shifting when space runs out. Default, form, menu, and rich variants set the padding, four widths fix the size, and PopoverAnchor lets it point at a different element than the trigger. PopoverMenuItem and PopoverRichMedia cover action lists and image headers. For hover-only previews of links or profiles, use Hover Card.

Installation

Run the following command

~/your-project
pnpm dlx wensity@latest add popover

Usage

Import Popover from @/components/wensity/popover and render it anywhere in your React or Next.js app. The source lands in your own repo, so every prop, class and animation below is yours to edit.

app/example.tsx
import {
Popover,
PopoverContent,
PopoverTrigger,
} from "@/components/wensity/popover";
export function PopoverDemo() {
return (
<Popover>
<PopoverTrigger>Open</PopoverTrigger>
<PopoverContent>Content</PopoverContent>
</Popover>
);
}

Props

PropTypeDefaultDescription
openboolean-Controlled open state.
defaultOpenboolean-Initial open state when uncontrolled.
onOpenChange(open: boolean) => void-Called when the popover opens or closes.
  • Gooey Dropdown Menu component preview

    Gooey Dropdown Menu

    A capsule trigger drips a menu out of its underside. Arrow keys, live shortcuts, and a clear Delete row come built in.

  • AI Model Selector component preview

    AI Model Selector

    An AI model selector dropdown that scales out from its trigger and glides the selection pill to whichever model you pick.

  • Follow Cursor Label component preview

    Follow Cursor Label

    A floating label that trails the cursor across your hover targets with an elastic pop-in and a soft spring settle.

  • Magnifying Glass Lens component preview

    Magnifying Glass Lens

    A glass lens that magnifies any child, bending at the rim as it follows.