Overlays
Popover
Floating overlay anchored to a trigger, built on react-aria-components and styled with the quebi design system. Reuses the dialog surface slots and is the foundation for menu, select, combo-box, and multiple-select.
overlaypopoverdropdownfloatingfoundational
Default
A trigger opens a popover with header, body, and footer.
With arrow
Set `arrow` to render an anchor arrow pointing at the trigger.
Simple content
PopoverContent accepts arbitrary children — no slots required.
Source
Copy this into your project. Resolve its dependencies from the registryDependencies in the component's API entry.
"use client"
import type { DialogTriggerProps, PopoverProps } from "react-aria-components"
import {
DialogTrigger as DialogTriggerPrimitive,
OverlayArrow,
Popover as PopoverPrimitive,
} from "react-aria-components"
import { cn } from "@/lib/utils"
import {
DialogBody,
DialogClose,
DialogDescription,
DialogFooter,
DialogHeader,
DialogTitle,
DialogTrigger,
} from "@/components/dialog"
/**
* Popover — quebi design system
*
* A floating overlay anchored to a trigger. Reuses the dialog surface slots
* (header/body/footer/title/description) inside a react-aria Popover. Foundational
* — menu / select / combo-box / multiple-select compose this overlay.
*
* Surface tokens: bg-quebi-bg, border-cyan-500/10, shadow-quebi-glow.
*/
const Popover = (props: DialogTriggerProps) => {
return <DialogTriggerPrimitive {...props} />
}
const PopoverTitle = DialogTitle
const PopoverHeader = DialogHeader
const PopoverBody = DialogBody
const PopoverFooter = DialogFooter
interface PopoverContentProps extends PopoverProps {
arrow?: boolean
ref?: React.Ref<HTMLDivElement>
}
const PopoverContent = ({
children,
arrow = false,
className,
ref,
...props
}: PopoverContentProps) => {
const offset = props.offset ?? (arrow ? 12 : 8)
return (
<PopoverPrimitive
ref={ref}
offset={offset}
className={cn(
"[--visual-viewport-vertical-padding:16px] sm:[--visual-viewport-vertical-padding:32px]",
"group/popover min-w-(--trigger-width) max-w-xs origin-(--trigger-anchor-point) rounded-quebi-md border border-cyan-500/10 bg-quebi-bg text-white shadow-quebi-glow outline-hidden transition-transform [--gutter:--spacing(4)] **:[[role=dialog]]:[--gutter:--spacing(4)]",
"entering:fade-in exiting:fade-out entering:animate-in exiting:animate-out",
"placement-left:entering:slide-in-from-right-1 placement-right:entering:slide-in-from-left-1 placement-top:entering:slide-in-from-bottom-1 placement-bottom:entering:slide-in-from-top-1",
"placement-left:exiting:slide-out-to-right-1 placement-right:exiting:slide-out-to-left-1 placement-top:exiting:slide-out-to-bottom-1 placement-bottom:exiting:slide-out-to-top-1",
"forced-colors:bg-[Canvas]",
className,
)}
{...props}
>
{(values) => (
<>
{arrow && (
<OverlayArrow className="group">
<svg
aria-hidden="true"
width={12}
height={12}
viewBox="0 0 12 12"
className="block fill-quebi-bg stroke-cyan-500/10 group-placement-bottom:rotate-180 group-placement-left:-rotate-90 group-placement-right:rotate-90 forced-colors:fill-[Canvas] forced-colors:stroke-[ButtonBorder]"
>
<path d="M0 0 L6 6 L12 0" />
</svg>
</OverlayArrow>
)}
<div data-slot="popover-inner" className="max-h-[inherit] overflow-y-auto">
{typeof children === "function" ? children(values) : children}
</div>
</>
)}
</PopoverPrimitive>
)
}
const PopoverTrigger = DialogTrigger
const PopoverClose = DialogClose
const PopoverDescription = DialogDescription
export type { PopoverContentProps, PopoverProps }
export {
Popover,
PopoverBody,
PopoverClose,
PopoverContent,
PopoverDescription,
PopoverFooter,
PopoverHeader,
PopoverTitle,
PopoverTrigger,
}