CKTIS / HTML
progress — progresso de uma tarefa
O elemento `progress` representa o progresso de uma tarefa: determinado através de `value` e `max`, ou indeterminado quando `value` está ausente. Não se destina a medições comuns.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<progress value="25" max="100">25 / 100</progress>
<progress></progress>progress descreve o progresso de uma tarefa, não uma medição geral; para o espaço em disco utilizado, use meter. São necessárias uma etiqueta de abertura e uma de fecho. Pode conter conteúdo de frase, mas não outro progress.
value indica o trabalho concluído e max o total. Ambos os atributos aceitam números de vírgula flutuante: max tem de ser positivo e value tem de estar entre 0 e max. O valor máximo predefinido é 1. Se max estiver ausente ou for inválido, o máximo é 1; um value inválido ou negativo é lido como 0, e um valor excessivo é limitado ao máximo.
A ausência de value significa que o progresso é indeterminado; value="0" significa um zero conhecido. Remova o atributo com removeAttribute('value') para regressar ao estado indeterminado. Em HTMLProgressElement, a propriedade só de leitura position devolve value / max ou -1 quando o progresso é indeterminado; nesse estado, a propriedade value devolve 0.
Associe um label através de for e id, como no exemplo. O texto interno fornece conteúdo alternativo para navegadores mais antigos, mas não define o valor. O exemplo termina com a barra completa e regista como texto os estados sucessivos.
Exemplos
<!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>Resultado
0.25 -1 1
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.