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