CKTIS / HTML
progress — voortgang van een taak
Het element `progress` geeft de voortgang van een taak weer: bepaald met `value` en `max`, of onbepaald wanneer `value` ontbreekt. Het is niet bedoeld voor gewone metingen.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<progress value="25" max="100">25 / 100</progress>
<progress></progress>progress beschrijft de voortgang van een taak, geen algemene meting; gebruik meter voor schijfruimtegebruik. Zowel een openingstag als een sluitingstag is vereist. Het element kan phrasing content bevatten, maar geen andere progress.
value geeft het voltooide werk aan en max het totaal. Beide attributen accepteren drijvendekommagetallen: max moet positief zijn en value moet tussen 0 en max liggen. De standaardmaximumwaarde is 1. Als max ontbreekt of ongeldig is, wordt het maximum 1; een ongeldige of negatieve value wordt gelezen als 0, en een te hoge waarde wordt begrensd op het maximum.
Een ontbrekende value betekent onbepaalde voortgang; value="0" betekent een bekende nul. Verwijder het attribuut met removeAttribute('value') om terug te keren naar de onbepaalde toestand. Bij HTMLProgressElement geeft de alleen-lezen eigenschap position value / max terug, of -1 bij onbepaalde voortgang; in die toestand geeft de eigenschap value 0 terug.
Koppel een label via for en id, zoals in het voorbeeld. De interne tekst biedt oudere browsers vervangende inhoud, maar stelt de waarde niet in. Het voorbeeld eindigt met een volle balk en legt de opeenvolgende toestanden vast als tekst.
Voorbeelden
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Progress example</title>
<label for="task">Task</label>
<progress id="task" value="25" max="100">25 / 100</progress>
<pre id="result"></pre>
<script>
const task = document.getElementById('task');
const lines = [String(task.position)];
task.removeAttribute('value');
lines.push(String(task.position));
task.value = 100;
task.textContent = '100 / 100';
lines.push(String(task.position));
document.getElementById('result').textContent = lines.join('\n');
</script>
</html>Resultaat
0.25 -1 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.