CKTIS / HTML
progress — progression d’une tâche
L’élément `progress` représente l’avancement d’une tâche : déterminé par `value` et `max`, ou indéterminé lorsque `value` est absent. Il n’est pas destiné aux mesures ordinaires.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<progress value="25" max="100">25 / 100</progress>
<progress></progress>progress décrit l’avancement d’une tâche, et non une mesure générale ; utilisez meter pour l’espace disque utilisé. Une balise ouvrante et une balise fermante sont toutes deux nécessaires. L’élément peut contenir du contenu phrasé, mais pas un autre progress.
value indique le travail accompli et max le total. Les deux attributs acceptent des nombres à virgule flottante : max doit être positif et value compris entre 0 et max. La valeur maximale par défaut est 1. Si max est absent ou invalide, le maximum vaut 1 ; un value invalide ou négatif est lu comme 0, et une valeur trop élevée est plafonnée au maximum.
L’absence de value signifie que la progression est indéterminée ; value="0" indique une valeur nulle connue. Supprimez l’attribut avec removeAttribute('value') pour revenir à l’état indéterminé. Sur HTMLProgressElement, la propriété en lecture seule position renvoie value / max, ou -1 lorsque la progression est indéterminée ; dans cet état, la propriété value renvoie 0.
Associez un label au moyen de for et id, comme dans l’exemple. Le texte interne sert de contenu de remplacement pour les anciens navigateurs, mais ne définit pas la valeur. L’exemple se termine par une barre complète et consigne les états successifs sous forme de texte.
Exemples
<!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>Résultat
0.25 -1 1
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.