CKTIS / JavaScript
HTMLProgressElement: propiedades max y value
`max` fija la cantidad total de trabajo y `value` la cantidad completada. Si falta el atributo `value`, el progreso es indeterminado, no del 0 %.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
const p = document.createElement("progress");
p.max = total;
p.value = completed;
const fraction = p.position;
p.removeAttribute("value");max y value son propiedades numéricas de lectura y escritura del DOM de un elemento <progress>, no funciones de ECMAScript. max representa el trabajo total y value el trabajo completado. Usa la misma unidad para ambas, por ejemplo, bytes. El límite inferior siempre es 0; un atributo min no lo cambia.
Al leer p.max se obtiene un número positivo, o 1 si el atributo max falta, no se puede interpretar como número o contiene un número no positivo. Asignar un número positivo a p.max establece el atributo; según el estándar, los números finitos no positivos se ignoran. Asignar NaN, Infinity o -Infinity a cualquiera de las dos propiedades lanza un TypeError.
Asignar un número finito a p.value establece el atributo value. Su presencia hace que el progreso sea determinado: al leer la propiedad, un valor de atributo negativo o no interpretable da 0, y un valor superior a p.max da p.max. Este ajuste a los límites no modifica el texto del atributo que devuelve p.getAttribute("value").
Sin el atributo value, el progreso es indeterminado aunque p.value siga devolviendo 0. La asignación p.value = 0 indica un progreso determinado del 0 %; p.removeAttribute("value") lo vuelve indeterminado. La propiedad de solo lectura p.position devuelve -1 en ese estado y p.value / p.max cuando el progreso es determinado.
Ejemplos
<!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>Resultado
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
Guarda el ejemplo como archivo HTML, ábrelo en un navegador y comprueba el resultado en la consola de desarrollo. La línea `over` muestra que el atributo conserva el texto `10`, mientras que la propiedad devuelve `8`. El elemento no se inserta en la página.
Lecciones relacionadas
- JavaScript · Lección 6 · Avanzado · Versión: 4