Popover
Popover shows rich contextual content attached to a trigger.
@duskmoon-dev/components/popoverUsage
When to use
- Use it when supporting content should stay attached to a trigger or task context.
- Prefer controlled open state when the surrounding workflow needs to react to dismissal.
Implementation notes
Features
Documents trigger, placement, and open-state patterns for content rendered above the page.
Highlights controlled state and close callbacks where overlays expose them.
Popover is most often configured through `title`, `content`, `placement`, `trigger`.
Renders title/content when hover opens and closes
Feature Demos
Feature demos are authored for the component page, then supplemented with behavior scenarios from the component test coverage.
No changes saved yet.
Interactive form
Open a real native Popover, edit the project name and submit the form. Save and cancel close the surface; the status reports actual edited values.
Source
import React, { useId, useRef, useState } from "react";
import "@duskmoon-dev/components/styles.css";
import { Popover } from "@duskmoon-dev/components/popover";
export function PopoverFormPreview() {
const [open, setOpen] = useState(false);
const [saved, setSaved] = useState("DuskMoon");
const [status, setStatus] = useState("No changes saved yet.");
const fieldId = useId();
const triggerRef = useRef<HTMLButtonElement>(null);
function close() {
setOpen(false);
triggerRef.current?.focus();
}
return <div data-overlay-form-demo style={{ display: "grid", gap: "0.75rem", justifyItems: "start" }}>
<Popover
title="Project settings"
trigger="click"
placement="bottom"
open={open}
onOpenChange={setOpen}
destroyTooltipOnHide
content={
<form aria-label="Project settings" onSubmit={(event) => {
event.preventDefault();
const value = String(new FormData(event.currentTarget).get("project"));
setSaved(value);
setStatus(`Saved project: ${value}`);
close();
}} style={{ display: "grid", gap: "0.75rem" }}>
<label htmlFor={fieldId}>Project name</label>
<input className="input" id={fieldId} name="project" defaultValue={saved} required />
<div style={{ display: "flex", gap: "0.5rem" }}>
<button className="btn btn-primary btn-sm" type="submit">Save project</button>
<button className="btn btn-ghost btn-sm" type="button" onClick={() => { setStatus("Changes canceled."); close(); }}>Cancel changes</button>
</div>
</form>
}
>
<button ref={triggerRef} className="btn btn-outlined" type="button">Edit project</button>
</Popover>
<p role="status" aria-atomic="true">{status}</p>
</div>;
}API
The API reference below lists every parsed exported type or interface for Popover. Start with `title`, `content`, `placement`, `trigger` for common usage.
packages/components/src/components/popover/Popover.types.tsScenarios: packages/components/src/components/popover/Popover.test.tsx| Prop | Type | Required | Description |
|---|---|---|---|
title | ReactNode | No | title configures Popover. |
content | ReactNode | No | content configures Popover. |
placement | PopoverPlacement | No | placement configures Popover. |
trigger | PopoverTrigger | No | trigger configures Popover. |
open | boolean | No | open configures Popover. |
defaultOpen | boolean | No | defaultOpen configures Popover. |
arrow | boolean | No | arrow configures Popover. |
destroyTooltipOnHide | boolean | No | destroyTooltipOnHide configures Popover. |
onOpenChange | (open: boolean) => void | No | onOpenChange configures Popover. |
children | ReactNode | Yes | children configures Popover. |
Type definition
"top" | "bottom" | "left" | "right"Type definition
"hover" | "focus" | "click" | "contextmenu"