Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

HTMLProgressElement: proprietà max e value

`max` indica la quantità totale di lavoro e `value` quella completata. Se manca l’attributo `value`, l’avanzamento è indeterminato, non pari allo 0%.

Versione: ECMAScript 2024 and the current web platform; runtime support varies

Sintassi

const p = document.createElement("progress");
p.max = total;
p.value = completed;
const fraction = p.position;
p.removeAttribute("value");

max e value sono proprietà numeriche del DOM, leggibili e scrivibili, di un elemento <progress>, non funzioni ECMAScript. max rappresenta il lavoro totale e value il lavoro completato. Usa la stessa unità per entrambe, per esempio i byte. Il limite inferiore è sempre 0: un attributo min non lo modifica.

La lettura di p.max restituisce un numero positivo, oppure 1 se l’attributo max manca, non è interpretabile come numero o contiene un numero non positivo. Assegnare un numero positivo a p.max imposta l’attributo; secondo lo standard, i numeri finiti non positivi vengono ignorati. Assegnare NaN, Infinity o -Infinity a una delle due proprietà genera un TypeError.

Assegnare un numero finito a p.value imposta l’attributo value. La sua presenza rende l’avanzamento determinato: in lettura, un valore di attributo negativo o non interpretabile dà 0, mentre un valore superiore a p.max dà p.max. Questa limitazione non modifica il testo dell’attributo restituito da p.getAttribute("value").

Senza l’attributo value, l’avanzamento è indeterminato anche se p.value restituisce ancora 0. L’assegnazione p.value = 0 indica un avanzamento determinato allo 0%; p.removeAttribute("value") lo rende di nuovo indeterminato. La proprietà di sola lettura p.position restituisce -1 in quello stato e p.value / p.max quando l’avanzamento è determinato.

Esempi

<!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>

Risultato

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

Salva l’esempio come file HTML, aprilo in un browser e controlla il risultato nella console per sviluppatori. La riga `over` mostra che l’attributo conserva il testo `10`, mentre la proprietà restituisce `8`. L’elemento non viene inserito nella pagina.

Lezioni correlate

  • JavaScript · Lezione 6 · Avanzato · Versione: 4

Fonti