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.