Komponenten
Fortschritt (Progress)
StabilZeigt, wie weit ein Vorgang ist – vom einzelnen Dienst bis zur Migration.
Ein Fortschritt zeigt, wie weit ein Vorgang gekommen ist: der Dienstplan ist zur Hälfte veröffentlicht, die Belegung wird berechnet. Der Balken beantwortet die Frage „Wie lange noch?“ mit einem Anteil.
Wann verwenden
- Für einen Vorgang mit bekanntem Ziel und bekannter Anzahl an Schritten.
- Wenn der Anteil wichtiger ist als die genaue Zahl, etwa beim Veröffentlichen eines Plans.
- Wenn der Vorgang länger dauert und die Seite nicht blockiert werden soll.
- Für einen Anteil an einem Ganzen, etwa belegte Betten einer Station.
Wann nicht
- Für einen einzelnen Wert ist eine Kennzahl genauer; ein Balken ohne Bezug sagt wenig.
- Für kurze Aktionen unter einer Sekunde genügt eine Ladeanzeige ohne Balken.
- Wenn nur „läuft“ oder „fertig“ zählt, reicht eine Ladeanzeige oder eine Kennzeichnung.
- Für Schritte mit Reihenfolge und Namen ist eine Schrittfolge (
Stepper) besser als ein anonymer Balken.
Mit Wert
value legt den Fortschritt fest, max den Bezugswert (Standard 100).
Im Beispiel erhöht eine Schaltfläche den Wert um 25 Prozentpunkte.
Dienstplan veröffentlicht25 %
dienstplan.tsx
import * as React from "react";
import { Button, Progress } from "@neodin-eu/ui";
function Dienstplan() {
const [fortschritt, setFortschritt] = React.useState(25);
return (
<div className="flex w-full max-w-md flex-col gap-3">
<div className="flex items-center justify-between gap-4 text-sm">
<span>Dienstplan veröffentlicht</span>
<span className="tabular-nums text-muted-foreground">{fortschritt} %</span>
</div>
<Progress value={fortschritt} aria-label="Dienstplan veröffentlicht" />
<Button
size="sm"
disabled={fortschritt === 100}
onClick={() => setFortschritt((wert) => Math.min(100, wert + 25))}
>
Schritt abschließen
</Button>
</div>
);
}Unbestimmt und eigener Bezugswert
Ohne value läuft der Balken unbestimmt; das passt, solange die Dauer nicht
feststeht. Mit max zählt der Balken in Schritten statt in Prozent.
Belegung wird berechnet …
Schritt 3 von 4
unbestimmt.tsx
import { Progress } from "@neodin-eu/ui";
function Unbestimmt() {
return (
<div className="flex w-full max-w-md flex-col gap-4">
<div className="flex flex-col gap-2">
<span className="text-sm">Belegung wird berechnet …</span>
<Progress aria-label="Belegung wird berechnet" />
</div>
<div className="flex flex-col gap-2">
<span className="text-sm">Schritt 3 von 4</span>
<Progress value={3} max={4} aria-label="Schritt 3 von 4" />
</div>
</div>
);
}Barrierefreiheit
- Der Balken hat die Rolle
progressbar.aria-valuenowundaria-valuemaxfolgen ausvalueundmax; das ist im Komponententest abgesichert. - Ein
aria-labelbenennt den Vorgang, etwa „Dienstplan veröffentlicht“. Im Test wird der Balken übergetByRole("progressbar", { name: … })gefunden. - Der Balken selbst ist nicht bedienbar; er meldet nur den Zustand.
- Der Fortschritt ist im Komponententest in hell und dunkel frei von axe-Verstößen.
Props
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| asChild | boolean | – | Nein | – |
| className | string | – | Nein | – |
| value | number | null | – | Nein | – |