CKTIS / JavaScript
HTMLProgressElement : progression d’une tâche avec max et value
HTMLProgressElement expose les propriétés max et value d’un élément progress. Elles décrivent la quantité totale de travail et la partie déjà accomplie, tout en permettant de distinguer une progression connue égale à zéro d’un état où le degré d’achèvement est inconnu.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
progress.max = total;
progress.value = completed;
progress.position;
progress.removeAttribute("value");HTMLProgressElement est l’interface DOM de l’élément progress, qui présente l’avancement d’une tâche. Progress max/value couvre deux propriétés numériques : max décrit la quantité totale de travail et value la partie accomplie. Il s’agit d’une API Web du navigateur, et non d’une fonctionnalité d’une édition particulière d’ECMAScript ; la seule présence de Node 24 ne prouve pas sa disponibilité.
max doit être supérieur à 0 et vaut 1 par défaut. value représente la progression de 0 à max et ne correspond donc pas nécessairement à un pourcentage. Avec max = 8 et value = 3, trois unités sur huit sont terminées. La valeur minimale est toujours 0 ; l’élément progress ne prend pas en charge l’attribut min.
Lorsque l’attribut value est présent, la progression est déterminée. La propriété en lecture seule position renvoie alors value / max. Si l’attribut value est absent, la progression est indéterminée : la lecture de value renvoie 0, mais position renvoie -1. Affecter value = 0 signifie que la progression est connue et égale à zéro, et non qu’elle est indéterminée. Utilisez removeAttribute("value") pour revenir à cet état.
Fournissez un nom accessible au moyen d’un élément label associé, de aria-label ou de aria-labelledby ; le texte à l’intérieur de l’élément ne remplace pas un libellé. MDN classe cette interface comme largement disponible dans les navigateurs depuis juillet 2015. L’exemple crée un élément détaché et montre la différence entre une progression connue égale à zéro et une progression inconnue, sans animation ni dépendance temporelle.
Exemples
(() => {
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}`);
})();Résultat
max=8, value=3, position=0.375 zero: value=0, position=0 unknown: value=0, position=-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.