Zum Inhalt springen
Dokumentation

Komponenten

Kurzinfo (Tooltip)

Stabil

Eine 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.

Beispiel und Quelltext
info.tsx
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.

Beispiel und Quelltext
symbol.tsx
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 über aria-describedby mit dem Auslöser.
  • Escape blendet 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

Props von Tooltip
PropTypStandardPflichtBeschreibung
onOpenChange((open: boolean) => void)–Nein–
openboolean–Nein–
Props von TooltipTrigger
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
disabledboolean–Nein–
Props von TooltipContent
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–

Siehe auch