Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

HTMLProgressElement: svojstva max i value

`max` određuje ukupnu količinu posla, a `value` obavljeni dio. Ako atribut `value` nedostaje, napredak je neodređen, a ne na 0 %.

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

Sintaksa

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

max i value brojčana su DOM svojstva elementa <progress> koja se mogu čitati i mijenjati; nisu funkcije ECMAScripta. max predstavlja ukupnu količinu posla, a value obavljeni dio. Za obje veličine upotrijebi istu jedinicu, primjerice bajtove. Donja je granica uvijek 0; atribut min ne može je promijeniti.

Čitanje p.max vraća pozitivan broj ili 1 ako atribut max nedostaje, ne može se protumačiti kao broj ili sadrži broj koji nije pozitivan. Dodjela pozitivnog broja svojstvu p.max postavlja atribut; standard zanemaruje konačne brojeve koji nisu pozitivni. Dodjela vrijednosti NaN, Infinity ili -Infinity bilo kojem od tih svojstava izaziva TypeError.

Dodjela konačnog broja svojstvu p.value postavlja atribut value. Ako je atribut prisutan, napredak je određen: pri čitanju svojstva negativna ili nečitljiva vrijednost atributa daje 0, a vrijednost iznad p.max daje p.max. To ograničavanje ne mijenja tekst atributa koji vraća p.getAttribute("value").

Bez atributa value napredak je neodređen, iako p.value i dalje vraća 0. Dodjela p.value = 0 znači određen napredak na 0 %; p.removeAttribute("value") vraća neodređeno stanje. Svojstvo p.position dostupno je samo za čitanje i tada vraća -1, a pri određenom napretku vraća p.value / p.max.

Primjeri

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

Rezultat

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

Spremi primjer kao HTML datoteku, otvori je u pregledniku i provjeri ispis u konzoli za razvojne programere. Redak `over` pokazuje da atribut zadržava tekst `10`, dok svojstvo vraća `8`. Element se ne umeće na stranicu.

Povezane lekcije

  • JavaScript · Lekcija 6 · Napredno · Verzija: 4

Izvori