CKTIS / JavaScript
HTMLProgressElement: de eigenschappen max en value
`max` geeft de totale hoeveelheid werk aan, `value` hoeveel ervan klaar is. Zonder het attribuut `value` is de voortgang onbepaald, niet 0%.
Versie: 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 en value zijn schrijfbare numerieke DOM-eigenschappen van een <progress>-element, geen ECMAScript-functies. max staat voor de totale hoeveelheid werk en value voor het voltooide deel. Gebruik voor beide dezelfde eenheid, bijvoorbeeld bytes. De ondergrens is altijd 0; een attribuut min verandert die niet.
Bij het uitlezen geeft p.max een positief getal, of 1 als het attribuut max ontbreekt, niet als getal kan worden gelezen of een niet-positief getal bevat. Een positief getal toewijzen aan p.max stelt het attribuut in; volgens de standaard worden eindige niet-positieve getallen genegeerd. Toewijzing van NaN, Infinity of -Infinity aan een van beide eigenschappen veroorzaakt een TypeError.
Een eindig getal toewijzen aan p.value stelt het attribuut value in. Als het attribuut aanwezig is, is de voortgang bepaald: bij het uitlezen levert een negatieve of niet als getal leesbare attribuutwaarde 0 op, en een waarde boven p.max levert p.max op. Deze begrenzing verandert de attribuuttekst die p.getAttribute("value") teruggeeft niet.
Zonder het attribuut value is de voortgang onbepaald, ook al geeft p.value nog steeds 0 terug. p.value = 0 betekent bepaalde voortgang van 0%; p.removeAttribute("value") maakt die weer onbepaald. De alleen-lezen-eigenschap p.position geeft dan -1 terug en bij bepaalde voortgang p.value / p.max.
Voorbeelden
<!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>Resultaat
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
Sla het voorbeeld op als HTML-bestand, open het in een browser en bekijk de uitvoer in de ontwikkelaarsconsole. De regel `over` laat zien dat het attribuut de tekst `10` behoudt, terwijl de eigenschap `8` teruggeeft. Het element wordt niet aan de pagina toegevoegd.
Gerelateerde lessen
- JavaScript · Les 6 · Gevorderd · Versie: 4