Komponenten
Kurzinfo (Tooltip)
StabilEine kurze Erklärung am Auslöser – für Symbole und Begriffe, die ohne Kontext unklar bleiben.
Ein Tooltip zeigt einen Satz direkt am Auslöser: die Bedeutung eines Symbols, eine Abkürzung oder eine kurze Regel. Er verschwindet beim nächsten Tastendruck oder sobald der Zeiger weiterzieht, und er blockiert nichts.
Wann verwenden
- Für ein Symbol ohne Beschriftung, etwa ein Fragezeichen neben einer Kennzahl zur Bettenbelegung.
- Für eine kurze Erklärung zu einem Begriff, die nicht dauerhaft auf der Seite stehen muss.
- Wenn der Hinweis nur ergänzt: Alles Wichtige steht bereits sichtbar auf der Seite.
Wann nicht
- Für Inhalt, den du lesen oder gar anklicken musst, sind Popover oder HoverCard die richtige Wahl.
- Auf Touch-Geräten gibt es kein Überfahren; der Hinweis muss dort anders erreichbar sein.
- Für Fehlermeldungen und Pflichtfeldhinweise ist Platz im Formular besser als ein Tooltip.
- Lange Texte gehören nicht in einen Tooltip – ein Satz genügt.
Kurze Hinweise
Tooltip hält den Zustand, TooltipTrigger ist der Auslöser und
TooltipContent zeigt den Text. Ohne eigene Konfiguration erscheint der
Hinweis sofort, weil TooltipProvider im Seitenrahmen delayDuration={0}
setzt.
import { Button, Tooltip, TooltipContent, TooltipTrigger } from "@neodin-eu/ui";
function Info() {
return (
<Tooltip>
<TooltipTrigger asChild>
<Button variant="outline">Schichtregeln</Button>
</TooltipTrigger>
<TooltipContent>Gilt für Früh- und Spätdienst</TooltipContent>
</Tooltip>
);
}TooltipProvider gehört einmal um die Anwendung, nicht um jeden einzelnen
Tooltip. Diese Seite bringt ihn bereits im Wurzel-Layout mit; in deiner
Anwendung setzt du ihn neben NeodinProvider in das Layout.
Symbol mit Namen
Ein Symbol allein braucht einen zugänglichen Namen: das aria-label an der
Schaltfläche. Der Tooltip ergänzt die Erklärung, er ersetzt die Beschriftung
nicht.
import { HelpCircle } from "lucide-react";
import { Button, Tooltip, TooltipContent, TooltipTrigger } from "@neodin-eu/ui";
function Symbol() {
return (
<Tooltip>
<TooltipTrigger asChild>
<Button variant="ghost" size="icon" aria-label="Hilfe zur Bettenbelegung">
<HelpCircle aria-hidden="true" />
</Button>
</TooltipTrigger>
<TooltipContent>Erklärt, wie belegte Betten gezählt werden</TooltipContent>
</Tooltip>
);
}Barrierefreiheit
- Der Hinweis erscheint auch, wenn der Auslöser den Tastaturfokus hat – nicht
nur beim Überfahren. Das ist im Komponententest abgesichert; er findet den
Hinweis über
getByRole("tooltip"). - Der Inhalt hat die Rolle
tooltip, Radix verbindet ihn überaria-describedbymit dem Auslöser. Escapeblendet den Hinweis aus; das ist das Verhalten der Radix-Grundlage.- Der offene Zustand ist im Komponententest in hell und dunkel frei von axe-Verstößen.
- Im Tooltip stehen keine Schaltflächen oder Links. Wer ihn nicht öffnen kann, findet dieselbe Information an anderer Stelle auf der Seite.
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 | – |
| disabled | boolean | – | Nein | – |
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| asChild | boolean | – | Nein | – |
| className | string | – | Nein | – |