Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

HTMLProgressElement: vlastnosti max a value

`max` udává celkové množství práce a `value` její dokončenou část. Pokud atribut `value` chybí, je průběh neurčitý; neznamená to, že bylo dokončeno 0 % práce.

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

Syntaxe

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

max a value jsou zapisovatelné číselné vlastnosti DOM prvku <progress>, nikoli funkce ECMAScriptu. max vyjadřuje celkové množství práce a value dokončené množství. Pro obě hodnoty používej stejnou jednotku, například bajty. Dolní mez je vždy 0; atribut min ji nezmění.

Při čtení p.max dostaneš kladné číslo, nebo 1, pokud atribut max chybí, nelze jej zpracovat jako číslo nebo obsahuje nekladné číslo. Přiřazení kladného čísla do p.max nastaví atribut; konečná nekladná čísla se podle standardu ignorují. Přiřazení NaN, Infinity nebo -Infinity do kterékoli z obou vlastností vyvolá TypeError.

Přiřazení konečného čísla do p.value nastaví atribut value. Jeho přítomnost znamená určitý průběh: při čtení vlastnosti dá záporná nebo nečitelná hodnota atributu 0 a hodnota nad p.max dá p.max. Toto omezení nemění text atributu, který vrací p.getAttribute("value").

Bez atributu value je průběh neurčitý, přestože p.value stále vrací 0. Přiřazení p.value = 0 znamená určitý průběh na 0 %; p.removeAttribute("value") obnoví neurčitý stav. Vlastnost p.position je jen pro čtení a v neurčitém stavu vrací -1, při určitém průběhu pak p.value / p.max.

Pří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ýsledek

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ž příklad jako soubor HTML, otevři ho v prohlížeči a zkontroluj výstup v konzoli pro vývojáře. Řádek `over` ukazuje, že atribut uchovává text `10`, zatímco vlastnost vrací `8`. Prvek se do stránky nevkládá.

Související lekce

  • JavaScript · Lekce 6 · Pokročilá · Verze: 4

Zdroje