Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

progress — progreso de una tarea

El elemento `progress` representa el progreso de una tarea: determinado mediante `value` y `max`, o indeterminado cuando falta `value`. No está pensado para mediciones corrientes.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

<progress value="25" max="100">25 / 100</progress>
<progress></progress>

progress describe el progreso de una tarea, no una medición general; para el espacio en disco utilizado, usa meter. Se necesitan tanto la etiqueta de apertura como la de cierre. Puede contener contenido de frase, pero no otro progress.

value indica el trabajo completado y max, el total. Ambos atributos aceptan números de coma flotante: max debe ser positivo y value debe estar entre 0 y max. El máximo predeterminado es 1. Si falta max o no es válido, el máximo pasa a ser 1; un value no válido o negativo se lee como 0, y un valor excesivo se limita al máximo.

La ausencia de value significa que el progreso es indeterminado; value="0" indica un cero conocido. Elimina el atributo con removeAttribute('value') para volver al estado indeterminado. En HTMLProgressElement, la propiedad de solo lectura position devuelve value / max o -1 cuando el progreso es indeterminado; en ese estado, la propiedad value devuelve 0.

Asocia un label mediante for e id, como se muestra. El texto interno ofrece contenido alternativo para navegadores antiguos, pero no establece el valor. El ejemplo termina con la barra completa y registra como texto los estados sucesivos.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes