Komponenten
Kennzahl (StatTile)
StabilEine 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.
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>
);
}Trends
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“.
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-ATunden-USgeprü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-onlyträ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 beipositiveIs: "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
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| className | string | – | Nein | – |
| delta | StatDelta | – | Nein | Optional trend indicator shown below the value. |
| format | NumberFormatOptions | – | Nein | `Intl.NumberFormat` options for numeric values. |
| hint | ReactNode | – | Nein | Small note below the value or delta. |
| label | string | – | Ja | Caption above the value. |
| value | string | number | – | Ja | Main figure; numbers are formatted with `format`. |