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.