Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

progress — postęp wykonania zadania

Element `progress` przedstawia postęp zadania: określony przez `value` i `max` albo nieokreślony, gdy brakuje `value`. Nie służy do prezentowania zwykłych pomiarów.

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

Składnia

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

progress opisuje wykonanie zadania, nie ogólny pomiar; do zajętości dysku użyj meter. Wymaga znacznika otwierającego i zamykającego. Może zawierać treść frazową, ale nie kolejny progress.

value określa wykonaną pracę, a max całość. Oba atrybuty przyjmują liczby zmiennoprzecinkowe: max musi być dodatnie, a value mieścić się między 0 a max. Domyślne maksimum wynosi 1. Brak lub błędne max daje maksimum 1; błędne lub ujemne value jest odczytywane jako 0, a zbyt duże jest ograniczane do maksimum.

Brak value oznacza postęp nieokreślony; value="0" oznacza znane zero. Usuń atrybut przez removeAttribute('value'), aby wrócić do stanu nieokreślonego. W HTMLProgressElement właściwość position jest tylko do odczytu: zwraca value / max lub -1 w stanie nieokreślonym; wtedy właściwość value zwraca 0.

Powiąż label przez for i id, jak w przykładzie. Tekst wewnętrzny zapewnia treść zastępczą dla starszych przeglądarek, lecz nie ustala wartości. Przykład kończy się pełnym paskiem; kolejne stany zapisuje jako tekst.

Przykłady

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

Wynik

0.25
-1
1

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła