CKTIS / JavaScript
HTMLProgressElement: vlastnosti max a value
`max` určuje celkové množstvo práce a `value` jej dokončenú časť. Ak atribút `value` chýba, priebeh je neurčitý; neznamená to 0 % dokončenia.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
const p = document.createElement("progress");
p.max = total;
p.value = completed;
const fraction = p.position;
p.removeAttribute("value");max a value sú zapisovateľné číselné vlastnosti DOM prvku <progress>, nie funkcie ECMAScriptu. max vyjadruje celkové množstvo práce a value dokončené množstvo. Pre obe hodnoty použi rovnakú jednotku, napríklad bajty. Dolná hranica je vždy 0; atribút min ju nezmení.
Pri čítaní p.max dostaneš kladné číslo alebo 1, ak atribút max chýba, nemožno ho spracovať ako číslo alebo obsahuje nekladné číslo. Priradenie kladného čísla do p.max nastaví atribút; konečné nekladné čísla sa podľa štandardu ignorujú. Priradenie NaN, Infinity alebo -Infinity do ktorejkoľvek z oboch vlastností vyvolá TypeError.
Priradenie konečného čísla do p.value nastaví atribút value. Jeho prítomnosť znamená určitý priebeh: pri čítaní vlastnosti dá záporná alebo nespracovateľná hodnota atribútu 0 a hodnota nad p.max dá p.max. Toto obmedzenie nemení text atribútu, ktorý vracia p.getAttribute("value").
Bez atribútu value je priebeh neurčitý, hoci p.value stále vracia 0. Priradenie p.value = 0 znamená určitý priebeh na 0 %; p.removeAttribute("value") obnoví neurčitý stav. Vlastnosť p.position je len na čítanie a v neurčitom stave vracia -1, pri určitom priebehu potom p.value / p.max.
Príklady
<!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>Výsledok
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
Ulož príklad ako súbor HTML, otvor ho v prehliadači a skontroluj výstup v konzole pre vývojárov. Riadok `over` ukazuje, že atribút uchováva text `10`, zatiaľ čo vlastnosť vracia `8`. Prvok sa nevkladá do stránky.
Súvisiace lekcie
- JavaScript · Lekcia 6 · Pokročilá · Verzia: 4