Surfacesduskmoonimplemented1 demos

Popover

Popover shows rich contextual content attached to a trigger.

Import@duskmoon-dev/components/popover
3API sections
10documented props
6behavior scenarios
Key API
titlecontentplacementtriggeropendefaultOpen

Usage

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

StylesheetImport @duskmoon-dev/components/styles.css once in the app or docs shell.
StateStart with default props for static examples, then switch to controlled props when state must be shared.
ThemeThe preview inherits the active DuskMoon data-theme value from the docs layout.

Features

Contextual surface

Documents trigger, placement, and open-state patterns for content rendered above the page.

Dismissal behavior

Highlights controlled state and close callbacks where overlays expose them.

Primary API surface

Popover is most often configured through `title`, `content`, `placement`, `trigger`.

Covered behavior

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.

Preview

No changes saved yet.

Interactive form

authored

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.

Types: packages/components/src/components/popover/Popover.types.tsScenarios: packages/components/src/components/popover/Popover.test.tsx
PopoverPropsinterface extends Omit< ComponentProps<"span">, "children" | "content" | "title" >
PropTypeRequiredDescription
titleReactNodeNotitle configures Popover.
contentReactNodeNocontent configures Popover.
placementPopoverPlacementNoplacement configures Popover.
triggerPopoverTriggerNotrigger configures Popover.
openbooleanNoopen configures Popover.
defaultOpenbooleanNodefaultOpen configures Popover.
arrowbooleanNoarrow configures Popover.
destroyTooltipOnHidebooleanNodestroyTooltipOnHide configures Popover.
onOpenChange(open: boolean) => voidNoonOpenChange configures Popover.
childrenReactNodeYeschildren configures Popover.
PopoverPlacementtype
Type definition
"top" | "bottom" | "left" | "right"
PopoverTriggertype
Type definition
"hover" | "focus" | "click" | "contextmenu"