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

CKTIS / JavaScript

HTMLProgressElement: průběh úlohy pomocí max a value

HTMLProgressElement zpřístupňuje vlastnosti max a value prvku progress. Popisují celkové množství práce a dokončenou část a umožňují rozlišit známý nulový průběh od stavu, kdy je míra dokončení neznámá.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

progress.max = total;
progress.value = completed;
progress.position;
progress.removeAttribute("value");

HTMLProgressElement je rozhraní DOM pro prvek progress, který zobrazuje průběh úlohy. Progress max/value zahrnuje dvě číselné vlastnosti: max popisuje celkové množství práce a value její dokončenou část. Jde o webové API prohlížeče, nikoli o funkci konkrétní edice ECMAScriptu; samotná přítomnost Node 24 nedokazuje jeho dostupnost.

max musí být větší než 0 a výchozí hodnota je 1. value představuje průběh od 0 do max, takže nemusí vyjadřovat procenta. Při max = 8 a value = 3 jsou dokončeny tři z osmi jednotek. Minimum je vždy 0; prvek progress nepodporuje atribut min.

Pokud je atribut value přítomen, je průběh určený. Vlastnost position pouze pro čtení pak vrací value / max. Chybí-li atribut value, je průběh neurčitý: čtení value vrátí 0, ale position vrátí -1. Přiřazení value = 0 znamená známý nulový průběh, nikoli neurčitý stav. Pro návrat do tohoto stavu použijte removeAttribute("value").

Zajistěte přístupný název pomocí přiřazeného prvku label, atributu aria-label nebo aria-labelledby; text uvnitř prvku nenahrazuje popisek. MDN klasifikuje rozhraní jako široce dostupné v prohlížečích od července 2015. Příklad vytvoří nepřipojený prvek a ukazuje rozdíl mezi známým nulovým a neznámým průběhem bez animace a časových závislostí.

Příklady

(() => {
  const progress = document.createElement("progress");
  progress.setAttribute("aria-label", "Task progress");
  progress.max = 8;
  progress.value = 3;
  console.log(`max=${progress.max}, value=${progress.value}, position=${progress.position}`);

  progress.value = 0;
  console.log(`zero: value=${progress.value}, position=${progress.position}`);

  progress.removeAttribute("value");
  console.log(`unknown: value=${progress.value}, position=${progress.position}`);
})();

Výsledek

max=8, value=3, position=0.375
zero: value=0, position=0
unknown: value=0, position=-1

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje