CKTIS / JavaScript
HTMLProgressElement : propriétés max et value
`max` fixe la quantité totale de travail et `value` la quantité déjà accomplie. Sans attribut `value`, la progression est indéterminée, et non à 0 %.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
const p = document.createElement("progress");
p.max = total;
p.value = completed;
const fraction = p.position;
p.removeAttribute("value");max et value sont deux propriétés numériques modifiables du DOM d’un élément <progress>, et non des fonctions ECMAScript. max représente le travail total et value le travail accompli. Utilisez la même unité pour les deux, par exemple des octets. La borne inférieure vaut toujours 0 ; un attribut min ne la change pas.
La lecture de p.max renvoie un nombre positif, ou 1 si l’attribut max est absent, ne peut pas être interprété comme un nombre ou contient un nombre nul ou négatif. Affecter un nombre positif à p.max définit l’attribut ; selon la norme, les nombres finis nuls ou négatifs sont ignorés. Affecter NaN, Infinity ou -Infinity à l’une ou l’autre propriété déclenche une TypeError.
Affecter un nombre fini à p.value définit l’attribut value. Sa présence rend la progression déterminée : à la lecture, une valeur d’attribut négative ou non interprétable donne 0, et une valeur supérieure à p.max donne p.max. Cette limitation ne modifie pas le texte de l’attribut renvoyé par p.getAttribute("value").
Sans l’attribut value, la progression est indéterminée, même si p.value renvoie 0. L’affectation p.value = 0 indique une progression déterminée à 0 % ; p.removeAttribute("value") la rend de nouveau indéterminée. La propriété en lecture seule p.position renvoie alors -1, et p.value / p.max si la progression est déterminée.
Exemples
<!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>Résultat
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
Enregistrez l’exemple dans un fichier HTML, ouvrez-le dans un navigateur et consultez le résultat dans la console de développement. La ligne `over` montre que l’attribut conserve le texte `10`, alors que la propriété renvoie `8`. L’élément n’est pas inséré dans la page.
Leçons associées
- JavaScript · Leçon 6 · Avancé · Version : 4