CKTIS / JavaScript
HTMLProgressElement: lastnosti max in value
`max` določa skupno količino dela, `value` pa količino opravljenega dela. Če atribut `value` manjka, je napredek nedoločen, ne pa na 0 %.
Različica: 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 in value sta številski lastnosti DOM elementa <progress>, ki ju je mogoče brati in nastavljati; nista funkciji ECMAScript. max predstavlja skupno količino dela, value pa količino opravljenega dela. Za obe uporabi isto enoto, na primer bajte. Spodnja meja je vedno 0; atribut min je ne spremeni.
Branje p.max vrne pozitivno število ali 1, če atribut max manjka, ga ni mogoče razčleniti kot število ali vsebuje nepozitivno število. Prireditev pozitivnega števila lastnosti p.max nastavi atribut; standard končna nepozitivna števila prezre. Prireditev vrednosti NaN, Infinity ali -Infinity kateri koli od obeh lastnosti sproži TypeError.
Prireditev končnega števila lastnosti p.value nastavi atribut value. Če je atribut prisoten, je napredek določen: pri branju lastnosti negativna ali nerazčlenljiva vrednost atributa da 0, vrednost nad p.max pa da p.max. Ta omejitev ne spremeni besedila atributa, ki ga vrne p.getAttribute("value").
Brez atributa value je napredek nedoločen, čeprav p.value še vedno vrne 0. Prireditev p.value = 0 pomeni določen napredek pri 0 %; p.removeAttribute("value") ga znova naredi nedoločenega. Lastnost p.position, ki je samo za branje, takrat vrne -1, pri določenem napredku pa p.value / p.max.
Primeri
<!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
Shrani primer kot datoteko HTML, odpri jo v brskalniku in preveri izpis v razvijalski konzoli. Vrstica `over` pokaže, da atribut ohrani besedilo `10`, lastnost pa vrne `8`. Element ni vstavljen na stran.
Povezane lekcije
- JavaScript · Lekcija 6 · Napredna · Različica: 4