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.