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

CKTIS / JavaScript

HTMLProgressElement: progreso de una tarea con max y value

HTMLProgressElement expone las propiedades max y value de un elemento progress. Describen la cantidad total de trabajo y la parte completada, y permiten distinguir entre un progreso conocido igual a cero y un estado en el que se desconoce el grado de finalización.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

progress.max = total;
progress.value = completed;
progress.position;
progress.removeAttribute("value");

HTMLProgressElement es la interfaz DOM del elemento progress, que presenta el avance de una tarea. Progress max/value abarca dos propiedades numéricas: max describe la cantidad total de trabajo y value la parte completada. Se trata de una API web del navegador, no de una característica de una edición concreta de ECMAScript; la mera presencia de Node 24 no demuestra que esté disponible.

max debe ser mayor que 0 y su valor predeterminado es 1. value representa el progreso de 0 a max, por lo que no tiene por qué ser un porcentaje. Con max = 8 y value = 3, se han completado tres de ocho unidades. El mínimo siempre es 0; el elemento progress no admite un atributo min.

Cuando el atributo value está presente, el progreso es determinado. La propiedad de solo lectura position devuelve entonces value / max. Si falta el atributo value, el progreso es indeterminado: al leer value se obtiene 0, pero position devuelve -1. Asignar value = 0 significa que se conoce un progreso igual a cero, no que sea indeterminado. Usa removeAttribute("value") para volver a ese estado.

Proporciona un nombre accesible mediante un elemento label asociado, aria-label o aria-labelledby; el texto dentro del elemento no sustituye a una etiqueta. MDN clasifica la interfaz como ampliamente disponible en navegadores desde julio de 2015. El ejemplo crea un elemento separado del documento y muestra la diferencia entre un progreso conocido igual a cero y uno desconocido, sin animaciones ni dependencias temporales.

Ejemplos

(() => {
  const progress = document.createElement("progress");
  progress.setAttribute("aria-label", "Task progress");
  progress.max = 8;
  progress.value = 3;
  console.log(`max=${progress.max}, value=${progress.value}, position=${progress.position}`);

  progress.value = 0;
  console.log(`zero: value=${progress.value}, position=${progress.position}`);

  progress.removeAttribute("value");
  console.log(`unknown: value=${progress.value}, position=${progress.position}`);
})();

Resultado

max=8, value=3, position=0.375
zero: value=0, position=0
unknown: value=0, position=-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