Zum Inhalt springen
Dokumentation

Komponenten

Popover

Stabil

Eine kleine Zusatzfläche am Auslöser – Filter, Erklärungen und kurze Auswahlen ohne Seitenwechsel.

Ein Popover öffnet sich auf Klick neben dem Auslöser und zeigt eine kleine Zusatzaufgabe: Filter, eine Erklärung oder eine kurze Auswahl. Es blockiert die Seite nicht und schließt beim nächsten Klick daneben.

Wann verwenden

  • Für kleine Filter direkt an der Liste, etwa „nur meine Tickets“.
  • Für eine kurze Erklärung zu einem Begriff oder Feld, die nicht dauerhaft auf der Seite stehen soll.
  • Für eine Auswahl, die du im Kontext brauchst und nicht auf einer eigenen Seite.

Wann nicht

  • Für eine Aufgabe, die den Fokus braucht, ist der Dialog richtig.
  • Für eine Rückfrage vor einer Aktion nimm den Bestätigungsdialog.
  • Für eine Textvorschau beim Überfahren gibt es HoverCard, für einen kurzen Hinweis den Tooltip.
  • Für mehrere gleichzeitig offene Zusatzflächen ist ein Seitenpanel ruhiger.

Filter an der Liste

Popover hält den Zustand, PopoverTrigger öffnet, PopoverContent zeigt den Inhalt. PopoverContent hat die Rolle dialog und braucht deshalb einen zugänglichen Namen – im Beispiel über aria-label.

Beispiel und Quelltext
filter.tsx
import { Button, Checkbox, Label, Popover, PopoverContent, PopoverTrigger } from "@neodin-eu/ui";

function Filter() {
  return (
    <Popover>
      <PopoverTrigger asChild>
        <Button variant="outline">Filter anpassen</Button>
      </PopoverTrigger>
      <PopoverContent aria-label="Filter für offene Tickets" className="w-80">
        <div className="flex flex-col gap-3">
          <p className="text-sm font-semibold">Offene Tickets</p>
          <div className="flex items-center gap-2">
            <Checkbox id="popover-nur-meine" defaultChecked />
            <Label htmlFor="popover-nur-meine">Nur meine Tickets</Label>
          </div>
          <div className="flex items-center gap-2">
            <Checkbox id="popover-nur-heute" />
            <Label htmlFor="popover-nur-heute">Nur heute fällig</Label>
          </div>
          <p className="text-xs text-muted-foreground">Die Auswahl gilt für die aktuelle Liste.</p>
        </div>
      </PopoverContent>
    </Popover>
  );
}

Kurze Erklärung

Ein Popover eignet sich auch für eine Erklärung, die du nur bei Bedarf öffnest. Der Auslöser bleibt eine Schaltfläche mit klarer Beschriftung, nicht ein bloßes Symbol ohne Namen.

Beispiel und Quelltext
hinweis.tsx
import { Button, Popover, PopoverContent, PopoverTrigger } from "@neodin-eu/ui";

function Hinweis() {
  return (
    <Popover>
      <PopoverTrigger asChild>
        <Button variant="ghost">Bereitschaft erklärt</Button>
      </PopoverTrigger>
      <PopoverContent aria-label="Erklärung zu Bereitschaft" className="w-80">
        <p className="text-sm">
          In der Bereitschaft bist du zu Hause erreichbar und wirst nur bei Bedarf gerufen. Die Zeit
          zählt anteilig als Arbeitszeit.
        </p>
        <p className="mt-2 text-xs text-muted-foreground">
          Die genauen Regeln stehen in der Dienstvereinbarung.
        </p>
      </PopoverContent>
    </Popover>
  );
}

Barrierefreiheit

  • Der offene Inhalt hat die Rolle dialog. Den zugänglichen Namen setzt du über aria-label am PopoverContent; im Komponententest wird er über getByRole("dialog", { name: "Filter" }) gefunden.
  • Escape schließt das Popover und setzt den Fokus zurück auf den Auslöser. Das ist im Komponententest abgesichert.
  • Der offene Zustand ist im Komponententest in hell und dunkel frei von axe-Verstößen.
  • Jedes Feld im Popover braucht eine Beschriftung – wie im Formular auf der Seite selbst.

Props

Props von Popover
PropTypStandardPflichtBeschreibung
onOpenChange((open: boolean) => void)–Nein–
openboolean–Nein–
Props von PopoverContent
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
Props von PopoverTrigger
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
disabledboolean–Nein–

Siehe auch