Komponenten
Vorschaukarte (HoverCard)
StabilEine kleine Vorschau beim Überfahren – Details zur Schicht oder Belegung, ohne die Seite zu verlassen.
Eine Vorschaukarte zeigt beim Überfahren oder per Tastaturfokus eine kleine Zusammenfassung: die Details zu einer Schicht, den Stand eines Betts, eine Kurzbeschreibung. Sie ist eine Ergänzung – der Inhalt bleibt im Fluss der Seite lesbar.
Wann verwenden
- Für eine kurze Vorschau auf eine verlinkte Stelle, etwa eine Schicht im Dienstplan.
- Für Zusatzdetails, die nur bei Bedarf stören sollen und nicht in jeder Zeile stehen müssen.
- Wenn der Auslöser bereits ein Link oder eine Schaltfläche ist und du keinen Klick erzwingen willst.
Wann nicht
- Für Inhalt mit Eingabefeldern nimm ein Popover: Die Karte schließt beim Weiterziehen des Zeigers.
- Für einen einzelnen Satz genügt ein Tooltip.
- Für eine Aufgabe, die den Fokus braucht, ist der Dialog richtig.
- Auf Touch-Geräten gibt es kein Überfahren – dort braucht die Information einen sichtbaren Platz oder eine eigene Seite.
Schichtvorschau
HoverCard hält den Zustand, HoverCardTrigger ist der Auslöser,
HoverCardContent zeigt die Karte. Mit openDelay und closeDelay steuerst
du, wie schnell die Karte erscheint und wieder verschwindet; im Beispiel stehen
beide auf 0, damit die Vorschau sofort reagiert.
uebergabe.tsx
import { Button, HoverCard, HoverCardContent, HoverCardTrigger, Separator } from "@neodin-eu/ui";
function Uebergabe() {
return (
<HoverCard openDelay={0} closeDelay={0}>
<HoverCardTrigger asChild>
<Button variant="link">Übergabe 06:00</Button>
</HoverCardTrigger>
<HoverCardContent>
<div className="flex flex-col gap-2">
<p className="text-sm font-semibold">Frühdienst, Station 3</p>
<p className="text-xs text-muted-foreground">06:00 bis 14:00 · sieben Betten belegt</p>
<Separator />
<p className="text-sm">Zwei offene Punkte: Materialbestellung und ein Befund.</p>
</div>
</HoverCardContent>
</HoverCard>
);
}Belegung im Blick
Der Auslöser darf ein Link sein: Die Vorschaukarte ergänzt ihn, statt ihn zu ersetzen. Ein Klick führt weiterhin zum Ziel des Links.
bett.tsx
import { Badge, HoverCard, HoverCardContent, HoverCardTrigger, Separator } from "@neodin-eu/ui";
function Bett() {
return (
<HoverCard openDelay={0} closeDelay={0}>
<HoverCardTrigger asChild>
<a href="#belegung" className="text-sm font-medium underline underline-offset-4">
Bett 12
</a>
</HoverCardTrigger>
<HoverCardContent>
<div className="flex flex-col gap-2">
<div className="flex items-center justify-between gap-3">
<p className="text-sm font-semibold">Bett 12, Station 3</p>
<Badge variant="secondary">Belegt</Badge>
</div>
<Separator />
<p className="text-sm">Aufnahme am Montag, Entlassung für Freitag geplant.</p>
</div>
</HoverCardContent>
</HoverCard>
);
}Barrierefreiheit
- Die Karte erscheint auch beim Tastaturfokus auf dem Auslöser, nicht nur beim Überfahren. Das ist im Komponententest abgesichert.
- Der Test findet den Inhalt über seinen Text und nicht über eine Rolle: Die Vorschaukarte ist eine Ergänzung, kein Dialog. Sie unterbricht die Arbeit nicht und fängt den Fokus nicht ein.
Escapeblendet die Karte aus; das ist das Verhalten der Radix-Grundlage.- Der offene Zustand ist im Komponententest in hell und dunkel frei von axe-Verstößen.
- Der Inhalt der Karte darf nicht die einzige Stelle sein, an der eine Information steht. Was für die Arbeit nötig ist, steht auch 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 | – |