База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

HTMLProgressElement: свойствата max и value

`max` задава общия обем работа, а `value` — извършената част. Ако атрибутът `value` липсва, напредъкът е неопределен, а не 0%.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

const p = document.createElement("progress");
p.max = total;
p.value = completed;
const fraction = p.position;
p.removeAttribute("value");

max и value са числови DOM свойства на елемент <progress>, които могат да се четат и задават, а не функции на ECMAScript. max е общият обем работа, а value — извършената част. Използвай една и съща мерна единица и за двете, например байтове. Долната граница винаги е 0; атрибут min не я променя.

При четене p.max връща положително число или 1, ако атрибутът max липсва, не може да се прочете като число или съдържа неположително число. Присвояването на положително число на p.max задава атрибута; според стандарта крайните неположителни числа се игнорират. Присвояването на NaN, Infinity или -Infinity на което и да е от двете свойства предизвиква TypeError.

Присвояването на крайно число на p.value задава атрибута value. Наличието му означава определен напредък: при четене отрицателна стойност или текст, който не може да се прочете като число, дава 0, а стойност над p.max дава p.max. Това ограничаване не променя текста на атрибута, който p.getAttribute("value") връща.

Без атрибута value напредъкът е неопределен, макар че p.value все още връща 0. Присвояването p.value = 0 означава определен напредък от 0%; p.removeAttribute("value") възстановява неопределеното състояние. Свойството p.position е само за четене и тогава връща -1, а при определен напредък — p.value / p.max.

Примери

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

Резултат

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

Запази примера като HTML файл, отвори го в браузър и провери резултата в конзолата за разработчици. Редът `over` показва, че атрибутът запазва текста `10`, а свойството връща `8`. Елементът не се добавя към страницата.

Свързани уроци

  • JavaScript · Урок 6 · Напреднало · Версия: 4

Източници