Zum Inhalt springen
Dokumentation

Komponenten

Fortschritt (Progress)

Stabil

Zeigt, 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 %
Beispiel und Quelltext
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
Beispiel und Quelltext
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-valuenow und aria-valuemax folgen aus value und max; das ist im Komponententest abgesichert.
  • Ein aria-label benennt den Vorgang, etwa „Dienstplan veröffentlicht“. Im Test wird der Balken über getByRole("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

Props von Progress
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
valuenumber | null–Nein–

Siehe auch