Komponenten
Popover
StabilEine 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.
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.
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 überaria-labelamPopoverContent; im Komponententest wird er übergetByRole("dialog", { name: "Filter" })gefunden. Escapeschließ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
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| onOpenChange | ((open: boolean) => void) | – | Nein | – |
| open | boolean | – | Nein | – |
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| asChild | boolean | – | Nein | – |
| className | string | – | Nein | – |
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| asChild | boolean | – | Nein | – |
| className | string | – | Nein | – |
| disabled | boolean | – | Nein | – |