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.