ComponentsPopover
Popover
A floating panel anchored to a trigger element, for displaying rich content on demand.
Usage
import { Popover, PopoverContent, PopoverTrigger } from "@/components/ui/popover"<Popover>
<PopoverTrigger asChild>
<Button variant="secondary">Open</Button>
</PopoverTrigger>
<PopoverContent>
<p>Popover content here.</p>
</PopoverContent>
</Popover>Installation
Via CLI
terminal
npx shadcn@latest add @solar-ui/popoverManual
1. Install the dependency:
terminal
npm install @radix-ui/react-popover2. Copy and paste the following code into your project:
components/ui/popover.tsx
"use client"
import { Popover as PopoverPrimitive } from "radix-ui"
import * as React from "react"
import { cn } from "@/lib/utils"
function Popover({
...props
}: React.ComponentProps<typeof PopoverPrimitive.Root>) {
return <PopoverPrimitive.Root data-slot="popover" {...props} />
}
function PopoverTrigger({
...props
}: React.ComponentProps<typeof PopoverPrimitive.Trigger>) {
return <PopoverPrimitive.Trigger data-slot="popover-trigger" {...props} />
}
function PopoverContent({
className,
align = "center",
sideOffset = 4,
...props
}: React.ComponentProps<typeof PopoverPrimitive.Content>) {
return (
<PopoverPrimitive.Portal>
<PopoverPrimitive.Content
data-slot="popover-content"
align={align}
sideOffset={sideOffset}
className={cn(
"bg-default-2 text-default-12 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-default-6 flex flex-col gap-2.5 rounded-lg p-2.5 text-sm shadow-md ring-1 duration-100 z-50 w-72 origin-(--radix-popover-content-transform-origin) outline-hidden",
className
)}
{...props}
/>
</PopoverPrimitive.Portal>
)
}
function PopoverAnchor({
...props
}: React.ComponentProps<typeof PopoverPrimitive.Anchor>) {
return <PopoverPrimitive.Anchor data-slot="popover-anchor" {...props} />
}
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 }: React.ComponentProps<"h2">) {
return (
<div
data-slot="popover-title"
className={cn("font-medium", className)}
{...props}
/>
)
}
function PopoverDescription({
className,
...props
}: React.ComponentProps<"p">) {
return (
<p
data-slot="popover-description"
className={cn("text-default-11", className)}
{...props}
/>
)
}
export {
Popover,
PopoverAnchor,
PopoverContent,
PopoverDescription,
PopoverHeader,
PopoverTitle,
PopoverTrigger
}API
Popover
| Prop | Type | Default | Description |
|---|---|---|---|
open | boolean | — | Controlled open state. |
defaultOpen | boolean | false | Initial open state (uncontrolled). |
onOpenChange | (open: boolean) => void | — | Callback when open state changes. |
modal | boolean | false | When true, blocks interaction with content outside the popover. |
PopoverContent
| Prop | Type | Default | Description |
|---|---|---|---|
side | "top" | "right" | "bottom" | "left" | "bottom" | Preferred side relative to the trigger. |
align | "start" | "center" | "end" | "center" | Alignment along the trigger’s axis. |
sideOffset | number | 4 | Gap in pixels between trigger and content. |
onOpenAutoFocus | (e: Event) => void | — | Override focus behavior on open. |
onCloseAutoFocus | (e: Event) => void | — | Override focus behavior on close. |
onEscapeKeyDown | (e: KeyboardEvent) => void | — | Handle Escape key press. |
onPointerDownOutside | (e: PointerEvent) => void | — | Handle pointer down outside the content. |
PopoverTrigger
| Prop | Type | Description |
|---|---|---|
asChild | boolean | Merge props onto child element instead of rendering a <button>. |
PopoverAnchor
An optional anchor element to position the popover against, independent of the trigger.
Last updated on