Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

progress — průběh úlohy

Prvek `progress` znázorňuje průběh úlohy: určený pomocí `value` a `max`, nebo neurčený, pokud `value` chybí. Není určen k zobrazování běžných měření.

Verze: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

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

progress popisuje průběh úlohy, nikoli obecnou veličinu; pro využití místa na disku použijte meter. Je nutná otevírací i uzavírací značka. Prvek může obsahovat frázový obsah, ale nesmí obsahovat další progress.

value udává dokončenou práci a max její celkový rozsah. Oba atributy přijímají desetinná čísla: max musí být kladné a value musí ležet mezi 0 a max. Výchozí maximum je 1. Pokud max chybí nebo je neplatné, maximum je 1; neplatné nebo záporné value se čte jako 0 a příliš vysoká hodnota se omezí na maximum.

Chybějící value znamená neurčený průběh; value="0" znamená známou nulovou hodnotu. Atribut odeberte pomocí removeAttribute('value'), chcete-li se vrátit do neurčeného stavu. U HTMLProgressElement vrací vlastnost position pouze pro čtení hodnotu value / max, nebo -1 při neurčeném průběhu; v tomto stavu vrací vlastnost value hodnotu 0.

Propojte label pomocí for a id, jak ukazuje příklad. Vnitřní text poskytuje náhradní obsah pro starší prohlížeče, ale nenastavuje hodnotu. Příklad končí plným pruhem a zaznamenává po sobě jdoucí stavy jako text.

Příklady

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

Výsledek

0.25
-1
1

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje