WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

progress — Fortschritt einer Aufgabe

Das Element `progress` zeigt den Fortschritt einer Aufgabe an: bestimmt durch `value` und `max` oder unbestimmt, wenn `value` fehlt. Es ist nicht für gewöhnliche Messwerte gedacht.

Version: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

<progress value="25" max="100">25 / 100</progress>
<progress></progress>

progress beschreibt den Fortschritt einer Aufgabe, keine allgemeine Messgröße; für den Speicherplatzverbrauch eignet sich meter. Es sind sowohl ein öffnendes als auch ein schließendes Tag erforderlich. Das Element kann Phrasing-Inhalt enthalten, aber kein weiteres progress.

value gibt die bereits erledigte Arbeit an, max die Gesamtmenge. Beide Attribute akzeptieren Gleitkommazahlen: max muss positiv sein und value zwischen 0 und max liegen. Der Standardwert für das Maximum ist 1. Fehlt max oder ist es ungültig, beträgt das Maximum 1; ein ungültiger oder negativer value wird als 0 gelesen, ein zu hoher Wert auf das Maximum begrenzt.

Ein fehlendes value bedeutet unbestimmten Fortschritt; value="0" steht für einen bekannten Wert von null. Entferne das Attribut mit removeAttribute('value'), um zum unbestimmten Zustand zurückzukehren. Bei HTMLProgressElement liefert die schreibgeschützte Eigenschaft position value / max oder im unbestimmten Zustand -1; in diesem Zustand gibt die Eigenschaft value 0 zurück.

Verknüpfe wie im Beispiel ein label über for und id. Der Text innerhalb des Elements dient älteren Browsern als Ersatzinhalt, legt aber nicht den Wert fest. Das Beispiel endet mit einem vollständig gefüllten Balken und hält die aufeinanderfolgenden Zustände als Text fest.

Beispiele

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Progress example</title>
<label for="task">Task</label>
<progress id="task" value="25" max="100">25 / 100</progress>
<pre id="result"></pre>
<script>
  const task = document.getElementById('task');
  const lines = [String(task.position)];
  task.removeAttribute('value');
  lines.push(String(task.position));
  task.value = 100;
  task.textContent = '100 / 100';
  lines.push(String(task.position));
  document.getElementById('result').textContent = lines.join('\n');
</script>
</html>

Ergebnis

0.25
-1
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