Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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

Sources