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.