Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

HTMLProgressElement: właściwości max i value

`max` określa całkowitą ilość pracy, a `value` ilość wykonaną. Brak atrybutu `value` oznacza postęp nieokreślony, a nie 0% wykonania.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

const p = document.createElement("progress");
p.max = total;
p.value = completed;
const fraction = p.position;
p.removeAttribute("value");

max i value to zapisywalne właściwości liczbowe DOM elementu <progress>, a nie funkcje ECMAScript. max oznacza całkowitą ilość pracy, a value ilość wykonaną. Obie wielkości podawaj w tej samej jednostce, na przykład w bajtach. Dolna granica to zawsze 0; atrybut min jej nie zmienia.

Odczyt p.max zwraca dodatnią liczbę albo 1, jeśli atrybut max nie istnieje, nie daje się odczytać jako liczba lub zawiera liczbę niedodatnią. Zapis dodatniej liczby do p.max ustawia atrybut; według standardu skończone liczby niedodatnie są ignorowane. Przypisanie NaN, Infinity lub -Infinity do którejkolwiek właściwości powoduje TypeError.

Przypisanie skończonej liczby do p.value ustawia atrybut value. Jeśli atrybut istnieje, postęp jest określony: przy odczycie wartość ujemna lub nieczytelna daje 0, a wartość powyżej p.max daje p.max. Ograniczenie wyniku odczytu nie zmienia tekstu atrybutu, który zwraca p.getAttribute("value").

Bez atrybutu value postęp jest nieokreślony, chociaż p.value nadal zwraca 0. Przypisanie p.value = 0 oznacza określone 0%; p.removeAttribute("value") przywraca stan nieokreślony. Właściwość p.position, dostępna tylko do odczytu, zwraca wtedy -1, a przy postępie określonym zwraca p.value / p.max.

Przykłady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>HTMLProgressElement: max and value</title>
</head>
<body>
  <script>
    const p = document.createElement("progress");
    console.log(`initial: max=${p.max}, value=${p.value}, position=${p.position}`);

    p.max = 8;
    p.value = 2;
    console.log(`partial: value=${p.value}, position=${p.position}`);

    p.value = 10;
    console.log(`over: attribute=${p.getAttribute("value")}, value=${p.value}, position=${p.position}`);

    p.removeAttribute("value");
    console.log(`removed: max=${p.max}, value=${p.value}, position=${p.position}`);
  </script>
</body>
</html>

Wynik

initial: max=1, value=0, position=-1
partial: value=2, position=0.25
over: attribute=10, value=8, position=1
removed: max=8, value=0, position=-1

Zapisz przykład jako plik HTML, otwórz go w przeglądarce i sprawdź wynik w konsoli deweloperskiej. Wiersz `over` pokazuje, że atrybut zachowuje tekst `10`, ale właściwość zwraca `8`. Element nie jest dodawany do strony.

Powiązane lekcje

  • JavaScript · Lekcja 6 · Zaawansowany · Wersja: 4

Źródła