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