Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

HTMLProgressElement: postęp zadania przez max i value

HTMLProgressElement udostępnia właściwości max i value elementu progress. Pozwalają one określić całkowity zakres pracy i wykonaną część oraz odróżnić znany postęp równy zero od stanu, w którym stopień ukończenia nie jest znany.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

progress.max = total;
progress.value = completed;
progress.position;
progress.removeAttribute("value");

HTMLProgressElement to interfejs DOM elementu progress, służącego do prezentowania postępu zadania. Temat Progress max/value obejmuje dwie właściwości liczbowe: max określa całkowitą ilość pracy, a value — część już wykonaną. Jest to przeglądarkowe Web API, a nie funkcja określonej edycji ECMAScript; sama obecność Node 24 nie dowodzi jego dostępności.

max musi być większe od 0; domyślnie wynosi 1. value reprezentuje postęp w zakresie od 0 do max, więc nie musi oznaczać procentów. Dla max = 8 i value = 3 ukończono trzy z ośmiu jednostek. Minimalna wartość jest zawsze równa 0; element progress nie obsługuje atrybutu min.

Gdy atrybut value jest obecny, postęp jest określony. Właściwość tylko do odczytu position zwraca wtedy value / max. Brak atrybutu value oznacza postęp nieokreślony: odczyt value zwraca 0, lecz position zwraca -1. Przypisanie value = 0 oznacza znane zero, a nie stan nieokreślony. Aby wrócić do tego stanu, użyj removeAttribute("value").

Zapewnij dostępną nazwę przez powiązany element label, aria-label albo aria-labelledby; tekst wewnątrz elementu nie zastępuje etykiety. MDN klasyfikuje interfejs jako szeroko dostępny w przeglądarkach od lipca 2015 r. Przykład tworzy odłączony element i pokazuje różnicę między znanym zerem a nieznanym postępem bez animacji i zależności od czasu.

Przykłady

(() => {
  const progress = document.createElement("progress");
  progress.setAttribute("aria-label", "Task progress");
  progress.max = 8;
  progress.value = 3;
  console.log(`max=${progress.max}, value=${progress.value}, position=${progress.position}`);

  progress.value = 0;
  console.log(`zero: value=${progress.value}, position=${progress.position}`);

  progress.removeAttribute("value");
  console.log(`unknown: value=${progress.value}, position=${progress.position}`);
})();

Wynik

max=8, value=3, position=0.375
zero: value=0, position=0
unknown: value=0, position=-1

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

Źródła