WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

HTMLProgressElement: Aufgabenfortschritt mit max und value

HTMLProgressElement stellt die Eigenschaften max und value eines progress-Elements bereit. Damit werden der Gesamtumfang der Arbeit und der bereits erledigte Anteil beschrieben. Außerdem lässt sich bekannter Fortschritt von null von einem Zustand unterscheiden, in dem der Abschlussgrad unbekannt ist.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

progress.max = total;
progress.value = completed;
progress.position;
progress.removeAttribute("value");

HTMLProgressElement ist die DOM-Schnittstelle für das Element progress, das den Fortschritt einer Aufgabe darstellt. Progress max/value umfasst zwei numerische Eigenschaften: max beschreibt den Gesamtumfang der Arbeit, value den bereits erledigten Anteil. Dies ist eine browserbasierte Web-API und keine Funktion einer bestimmten ECMAScript-Version; allein das Vorhandensein von Node 24 belegt nicht, dass sie verfügbar ist.

max muss größer als 0 sein und hat standardmäßig den Wert 1. value stellt den Fortschritt von 0 bis max dar und muss daher keinen Prozentwert angeben. Bei max = 8 und value = 3 sind drei von acht Einheiten erledigt. Der Mindestwert ist immer 0; das Element progress unterstützt kein min-Attribut.

Wenn das Attribut value vorhanden ist, ist der Fortschritt bestimmt. Die schreibgeschützte Eigenschaft position gibt dann value / max zurück. Fehlt das Attribut value, ist der Fortschritt unbestimmt: Beim Lesen gibt value den Wert 0 zurück, position dagegen -1. Die Zuweisung value = 0 bedeutet bekannter Fortschritt von null und nicht einen unbestimmten Zustand. Verwende removeAttribute("value"), um zu diesem Zustand zurückzukehren.

Stelle einen zugänglichen Namen über ein zugeordnetes label-Element, aria-label oder aria-labelledby bereit; Text innerhalb des Elements ersetzt keine Beschriftung. MDN stuft die Schnittstelle seit Juli 2015 als breit in Browsern verfügbar ein. Das Beispiel erstellt ein nicht angehängtes Element und veranschaulicht den Unterschied zwischen bekanntem Fortschritt von null und unbekanntem Fortschritt, ohne Animationen oder zeitliche Abhängigkeiten.

Beispiele

(() => {
  const progress = document.createElement("progress");
  progress.setAttribute("aria-label", "Task progress");
  progress.max = 8;
  progress.value = 3;
  console.log(`max=${progress.max}, value=${progress.value}, position=${progress.position}`);

  progress.value = 0;
  console.log(`zero: value=${progress.value}, position=${progress.position}`);

  progress.removeAttribute("value");
  console.log(`unknown: value=${progress.value}, position=${progress.position}`);
})();

Ergebnis

max=8, value=3, position=0.375
zero: value=0, position=0
unknown: value=0, position=-1

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen