CKTIS / HTML
progress — avanzamento di un’attività
L’elemento `progress` rappresenta l’avanzamento di un’attività: determinato tramite `value` e `max`, oppure indeterminato quando manca `value`. Non è pensato per le misurazioni ordinarie.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<progress value="25" max="100">25 / 100</progress>
<progress></progress>progress descrive l’avanzamento di un’attività, non una misurazione generale; per lo spazio su disco utilizzato, usa meter. Sono necessari sia il tag di apertura sia quello di chiusura. Può contenere contenuto di frase, ma non un altro progress.
value indica il lavoro completato e max il totale. Entrambi gli attributi accettano numeri a virgola mobile: max deve essere positivo e value deve essere compreso tra 0 e max. Il valore massimo predefinito è 1. Se max manca o non è valido, il massimo è 1; un value non valido o negativo viene letto come 0, mentre un valore eccessivo viene limitato al massimo.
L’assenza di value indica un avanzamento indeterminato; value="0" indica uno zero noto. Rimuovi l’attributo con removeAttribute('value') per tornare allo stato indeterminato. In HTMLProgressElement, la proprietà di sola lettura position restituisce value / max oppure -1 quando l’avanzamento è indeterminato; in questo stato, la proprietà value restituisce 0.
Associa un label tramite for e id, come mostrato. Il testo interno fornisce contenuto alternativo per i browser meno recenti, ma non imposta il valore. L’esempio termina con la barra completa e registra come testo gli stati successivi.
Esempi
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Progress example</title>
<label for="task">Task</label>
<progress id="task" value="25" max="100">25 / 100</progress>
<pre id="result"></pre>
<script>
const task = document.getElementById('task');
const lines = [String(task.position)];
task.removeAttribute('value');
lines.push(String(task.position));
task.value = 100;
task.textContent = '100 / 100';
lines.push(String(task.position));
document.getElementById('result').textContent = lines.join('\n');
</script>
</html>Risultato
0.25 -1 1
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.