KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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

Bronnen