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

CKTIS / HTML

progress — напредък на задача

Елементът `progress` представя напредъка на задача: определен чрез `value` и `max` или неопределен, когато `value` липсва. Не е предназначен за обичайни измервания.

Версия: WHATWG HTML Living Standard; index snapshot date recorded separately

Синтаксис

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

progress описва напредъка на задача, а не общо измерване; за използваното дисково пространство използвайте meter. Необходими са както отварящ, така и затварящ таг. Елементът може да съдържа фразово съдържание, но не и друг progress.

value задава свършената работа, а max — общото количество. И двата атрибута приемат числа с плаваща запетая: max трябва да е положително, а value трябва да е между 0 и max. Стойността по подразбиране за максимума е 1. Ако max липсва или е невалидно, максимумът е 1; невалидно или отрицателно value се прочита като 0, а прекалено голяма стойност се ограничава до максимума.

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

Свържете label чрез for и id, както е показано. Вътрешният текст осигурява резервно съдържание за по-стари браузъри, но не задава стойността. Примерът завършва с пълна лента и записва последователните състояния като текст.

Примери

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

Резултат

0.25
-1
1

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници