WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

HTMLProgressElement: die Eigenschaften max und value

`max` legt den gesamten Arbeitsumfang fest, `value` den bereits erledigten Teil. Fehlt das Attribut `value`, ist der Fortschritt unbestimmt und steht nicht bei 0 %.

Version: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

const p = document.createElement("progress");
p.max = total;
p.value = completed;
const fraction = p.position;
p.removeAttribute("value");

max und value sind beschreibbare numerische DOM-Eigenschaften eines <progress>-Elements, keine ECMAScript-Funktionen. max steht für den gesamten Arbeitsumfang, value für den erledigten Teil. Verwende für beide dieselbe Einheit, etwa Bytes. Die Untergrenze ist immer 0; ein Attribut min ändert sie nicht.

Beim Lesen liefert p.max eine positive Zahl oder 1, wenn das Attribut max fehlt, sich nicht als Zahl auswerten lässt oder eine nichtpositive Zahl enthält. Eine positive Zuweisung an p.max setzt das Attribut; endliche nichtpositive Zahlen werden laut Standard ignoriert. Die Zuweisung von NaN, Infinity oder -Infinity an eine der beiden Eigenschaften löst einen TypeError aus.

Die Zuweisung einer endlichen Zahl an p.value setzt das Attribut value. Ist es vorhanden, ist der Fortschritt bestimmt: Beim Lesen ergibt ein negativer oder nicht als Zahl lesbarer Attributwert 0, ein Wert über p.max ergibt p.max. Diese Begrenzung verändert den von p.getAttribute("value") gelieferten Attributtext nicht.

Fehlt das Attribut value, ist der Fortschritt unbestimmt, obwohl p.value weiterhin 0 liefert. p.value = 0 bedeutet bestimmten Fortschritt bei 0 %; p.removeAttribute("value") stellt den unbestimmten Zustand wieder her. Die schreibgeschützte Eigenschaft p.position liefert dann -1, bei bestimmtem Fortschritt dagegen p.value / p.max.

Beispiele

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>HTMLProgressElement: max and value</title>
</head>
<body>
  <script>
    const p = document.createElement("progress");
    console.log(`initial: max=${p.max}, value=${p.value}, position=${p.position}`);

    p.max = 8;
    p.value = 2;
    console.log(`partial: value=${p.value}, position=${p.position}`);

    p.value = 10;
    console.log(`over: attribute=${p.getAttribute("value")}, value=${p.value}, position=${p.position}`);

    p.removeAttribute("value");
    console.log(`removed: max=${p.max}, value=${p.value}, position=${p.position}`);
  </script>
</body>
</html>

Ergebnis

initial: max=1, value=0, position=-1
partial: value=2, position=0.25
over: attribute=10, value=8, position=1
removed: max=8, value=0, position=-1

Speichere das Beispiel als HTML-Datei, öffne sie im Browser und überprüfe die Ausgabe in der Entwicklerkonsole. Die Zeile `over` zeigt, dass im Attribut der Text `10` steht, während die Eigenschaft `8` liefert. Das Element wird nicht in die Seite eingefügt.

Zugehörige Lektionen

  • JavaScript · Lektion 6 · Fortgeschritten · Version: 4

Quellen