Zum Inhalt springen
Dokumentation

Komponenten

Kennzahl (StatTile)

Stabil

Eine Zahl mit Einordnung – für offene Dienste, Belegung und Trends.

Eine Kennzahl zeigt einen einzelnen Wert mit Beschriftung: offene Dienste, Bettenbelegung, offene Tickets. Sie beantwortet eine Frage auf einen Blick und lässt sich mit einer Veränderung oder einem Hinweis einordnen.

Wann verwenden

  • Für die wichtigsten Werte einer Übersicht, etwa drei bis vier Kennzahlen über einer Liste.
  • Wenn eine Veränderung wichtig ist: plus oder minus seit gestern, seit Monatsbeginn.
  • Wenn eine Zahl formatiert werden muss – Prozent, Währung, Nachkommastellen.
  • Wenn der Wert selbst erklärt werden soll, etwa „Stand heute, 08:00 Uhr“.

Wann nicht

  • Für einen Verlauf über mehrere Tage sind Diagramme die richtige Wahl; eine einzelne Kennzahl zeigt den Trend nicht.
  • Für eine Liste mit mehreren Werten pro Eintrag ist eine Tabelle besser.
  • Für einen erklärenden Satz genügt ein Hinweis; eine Kennzahl braucht eine kurze, eindeutige Beschriftung.
  • Für viele Kennzahlen nebeneinander wird die Übersicht unruhig. Wähle die wenigen, die eine Entscheidung tragen.

Aufbau

label benennt den Wert, value trägt die Zahl oder einen kurzen Text. format folgt Intl.NumberFormat, etwa { style: "percent" }. hint ergänzt eine kleine Zeile mit Zeitpunkt oder Bezug.

Offene Dienste8-2fallendStand heute, 08:00 Uhr
Bettenbelegung84 %Station 1 bis 4
Offene Tickets12+3steigendLetzte 24 Stunden
Beispiel und Quelltext
offene-dienste.tsx
import { StatTile } from "@neodin-eu/ui";

function OffeneDienste() {
  return (
    <div className="grid w-full gap-4 sm:grid-cols-3">
      <StatTile
        label="Offene Dienste"
        value={8}
        delta={{ value: 2, direction: "down", positiveIs: "down" }}
        hint="Stand heute, 08:00 Uhr"
      />
      <StatTile
        label="Bettenbelegung"
        value={0.84}
        format={{ style: "percent", maximumFractionDigits: 0 }}
        hint="Station 1 bis 4"
      />
      <StatTile
        label="Offene Tickets"
        value={12}
        delta={{ value: 3, direction: "up", positiveIs: "down" }}
        hint="Letzte 24 Stunden"
      />
    </div>
  );
}

delta beschreibt die Veränderung mit value und direction (up, down oder flat). positiveIs legt fest, welche Richtung als gut gilt: Sinken offene Dienste, ist das ein Erfolg, steigende offene Tickets sind es nicht. Die Farbe allein trägt die Aussage nicht – Screenreader bekommen zusätzlich „steigend“, „fallend“ oder „unverändert“.

Durchlaufzeit3,5 TageMedian der letzten Woche
Verweildauer4,20unverändertDurchschnitt der Station 3
Beispiel und Quelltext
trends.tsx
import { StatTile } from "@neodin-eu/ui";

function Trends() {
  return (
    <div className="grid w-full gap-4 sm:grid-cols-2">
      <StatTile label="Durchlaufzeit" value="3,5 Tage" hint="Median der letzten Woche" />
      <StatTile
        label="Verweildauer"
        value={4.2}
        format={{ maximumFractionDigits: 1 }}
        delta={{ value: 0, direction: "flat" }}
        hint="Durchschnitt der Station 3"
      />
    </div>
  );
}

Barrierefreiheit

  • Zahl und Beschriftung stehen als Text in der Kachel. Zahlen werden mit der Sprache der Anwendung formatiert; im Komponententest wird das an de-AT und en-US geprüft.
  • Die Richtung des Trends steht zusätzlich als ausgeblendeter Text bereit („steigend“, „fallend“, „unverändert“). Im Test wird geprüft, dass dieser Text die Klasse sr-only trägt.
  • Das Trend-Symbol ist aria-hidden; die Aussage kommt aus dem Text.
  • Die Farbe richtet sich nach positiveIs. Im Test wird geprüft, dass ein sinkender Wert bei positiveIs: "down" die Erfolgsfarbe trägt – Farbe ist also nicht der einzige Hinweis.
  • Die Kachel ist im Komponententest in hell und dunkel frei von axe-Verstößen.

Props

Props von StatTile
PropTypStandardPflichtBeschreibung
classNamestring–Nein–
deltaStatDelta–NeinOptional trend indicator shown below the value.
formatNumberFormatOptions–Nein`Intl.NumberFormat` options for numeric values.
hintReactNode–NeinSmall note below the value or delta.
labelstring–JaCaption above the value.
valuestring | number–JaMain figure; numbers are formatted with `format`.

Siehe auch