KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

HTMLProgressElement: taakvoortgang met max en value

HTMLProgressElement biedt de eigenschappen max en value van een progress-element. Daarmee worden de totale hoeveelheid werk en het voltooide deel beschreven. Ook kun je bekende voortgang van nul onderscheiden van een toestand waarin de mate van voltooiing onbekend is.

Versie: 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 is de DOM-interface voor het element progress, dat de voortgang van een taak weergeeft. Progress max/value omvat twee numerieke eigenschappen: max beschrijft de totale hoeveelheid werk en value het voltooide deel. Dit is een browser-Web-API, geen functie van een bepaalde ECMAScript-editie; alleen de aanwezigheid van Node 24 bewijst niet dat de API beschikbaar is.

max moet groter zijn dan 0 en is standaard 1. value geeft de voortgang van 0 tot max weer en hoeft dus geen percentage te zijn. Bij max = 8 en value = 3 zijn drie van de acht eenheden voltooid. De minimumwaarde is altijd 0; het element progress ondersteunt geen min-attribuut.

Als het attribuut value aanwezig is, is de voortgang bepaald. De alleen-lezen eigenschap position geeft dan value / max terug. Ontbreekt het attribuut value, dan is de voortgang onbepaald: het uitlezen van value geeft 0 terug, maar position geeft -1. De toekenning value = 0 betekent bekende voortgang van nul, niet een onbepaalde toestand. Gebruik removeAttribute("value") om naar die toestand terug te keren.

Geef het element een toegankelijke naam met een gekoppeld label-element, aria-label of aria-labelledby; tekst binnen het element vervangt geen label. MDN classificeert de interface sinds juli 2015 als breed beschikbaar in browsers. Het voorbeeld maakt een niet-gekoppeld element en laat het verschil zien tussen bekende voortgang van nul en onbekende voortgang, zonder animatie of tijdsafhankelijkheid.

Voorbeelden

(() => {
  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}`);
})();

Resultaat

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

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen