Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

HTMLProgressElement: priebeh úlohy pomocou max a value

HTMLProgressElement sprístupňuje vlastnosti max a value prvku progress. Opisujú celkové množstvo práce a dokončenú časť a umožňujú rozlíšiť známy nulový priebeh od stavu, keď je miera dokončenia neznáma.

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

Syntax

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

HTMLProgressElement je rozhranie DOM pre prvok progress, ktorý zobrazuje priebeh úlohy. Progress max/value zahŕňa dve číselné vlastnosti: max opisuje celkové množstvo práce a value jej dokončenú časť. Ide o webové API prehliadača, nie o funkciu konkrétnej edície ECMAScriptu; samotná prítomnosť Node 24 nedokazuje jeho dostupnosť.

max musí byť väčšie ako 0 a predvolená hodnota je 1. value predstavuje priebeh od 0 po max, takže nemusí vyjadrovať percentá. Pri max = 8 a value = 3 sú dokončené tri z ôsmich jednotiek. Minimum je vždy 0; prvok progress nepodporuje atribút min.

Ak je atribút value prítomný, priebeh je určený. Vlastnosť position iba na čítanie potom vracia value / max. Ak atribút value chýba, priebeh je neurčitý: čítanie value vráti 0, ale position vráti -1. Priradenie value = 0 znamená známy nulový priebeh, nie neurčitý stav. Na návrat do tohto stavu použite removeAttribute("value").

Zabezpečte prístupný názov pomocou priradeného prvku label, atribútu aria-label alebo aria-labelledby; text vnútri prvku nenahrádza popis. MDN klasifikuje rozhranie ako široko dostupné v prehliadačoch od júla 2015. Príklad vytvorí nepripojený prvok a ukazuje rozdiel medzi známym nulovým a neznámym priebehom bez animácie a časových závislostí.

Prí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ýsledok

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

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje