Zum Inhalt springen

Dokumentation

Komponenten

Progress Bars

Fortschrittsbalken zeigen den Prozentsatz einer Aufgabe und motivieren, einen Vorgang abzuschließen.

Verwendung

Ein Progress Bar zeigt, wie viel einer Aufgabe bereits erledigt ist. Mit value und optional max wird der Prozentsatz berechnet.

Standard-Progress-Bar
blade
<gedisa:progress value="40" aria-label="Upload" />

Beschriftung

label blendet den Prozentwert ein: rechts neben dem Balken, darunter oder schwebend über bzw. unter dem Füllstand.

Rechts und unten
blade
<gedisa:progress value="40" label="right" aria-label="Upload" />
<gedisa:progress value="40" label="bottom" aria-label="Upload" />
Schwebend oben und unten
blade
<gedisa:progress value="40" label="top-floating" aria-label="Upload" />
<gedisa:progress value="40" label="bottom-floating" aria-label="Upload" />

Eigenes Maximum

Mit max lassen sich absolute Werte übergeben, zum Beispiel erledigte Schritte eines Onboardings.

3 von 8 Schritten
blade
<gedisa:progress value="3" max="8" label="right" aria-label="Onboarding" />

Livewire

Der Balken animiert Änderungen des Werts. Das Beispiel simuliert einen Upload per wire:poll und lässt sich schrittweise anpassen.

Live-Fortschritt
blade
<gedisa:progress :value="$progress" label="top-floating" aria-label="Upload" />

Referenz

Diese Übersicht umfasst die gezeigten Attribute. Das Element setzt role="progressbar" und die passenden ARIA-Werte automatisch.

gedisa:progress

Eigenschaft
Werte
Default
value Aktueller Wert
max Maximalwert für die Prozentberechnung 100
label right, bottom, top-floating, bottom-floating
aria-label Zugänglicher Name des Fortschritts