CKTIS / JavaScript
HTMLProgressElement: napredak zadatka pomoću max i value
HTMLProgressElement izlaže svojstva max i value elementa progress. Ona opisuju ukupnu količinu posla i dovršeni dio te omogućuju razlikovanje poznatog napretka od nule od stanja u kojem je razina dovršenosti nepoznata.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
progress.max = total;
progress.value = completed;
progress.position;
progress.removeAttribute("value");HTMLProgressElement je DOM sučelje za element progress, koji prikazuje napredak zadatka. Progress max/value obuhvaća dva numerička svojstva: max opisuje ukupnu količinu posla, a value dovršeni dio. To je web-API preglednika, a ne značajka određene verzije ECMAScripta; sama prisutnost Nodea 24 ne dokazuje njegovu dostupnost.
max mora biti veći od 0, a zadana mu je vrijednost 1. value predstavlja napredak od 0 do max, pa ne mora označavati postotak. Uz max = 8 i value = 3 dovršene su tri od osam jedinica. Najmanja je vrijednost uvijek 0; element progress ne podržava atribut min.
Kad je atribut value prisutan, napredak je određen. Svojstvo position, dostupno samo za čitanje, tada vraća value / max. Ako atribut value nedostaje, napredak je neodređen: čitanje svojstva value vraća 0, ali position vraća -1. Dodjela value = 0 znači poznat napredak od nule, a ne neodređeno stanje. Upotrijebite removeAttribute("value") za povratak u to stanje.
Osigurajte pristupačan naziv pomoću povezanog elementa label, atributa aria-label ili aria-labelledby; tekst unutar elementa ne zamjenjuje oznaku. MDN sučelje klasificira kao široko dostupno u preglednicima od srpnja 2015. Primjer stvara odvojeni element i prikazuje razliku između poznatog napretka od nule i nepoznatog napretka, bez animacije ili vremenskih ovisnosti.
Primjeri
(() => {
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}`);
})();Rezultat
max=8, value=3, position=0.375 zero: value=0, position=0 unknown: value=0, position=-1
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.