CKTIS / JavaScript
HTMLProgressElement: napredek opravila z max in value
HTMLProgressElement izpostavlja lastnosti max in value elementa progress. Opisujeta skupno količino dela in dokončani del ter omogočata razlikovanje med znanim ničelnim napredkom in stanjem, ko stopnja dokončanosti ni znana.
Različica: 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 vmesnik DOM za element progress, ki prikazuje napredek opravila. Progress max/value zajema dve številski lastnosti: max opisuje skupno količino dela, value pa dokončani del. To je spletni API brskalnika, ne funkcija določene izdaje ECMAScripta; zgolj prisotnost Node 24 ne dokazuje njegove razpoložljivosti.
max mora biti večji od 0, privzeta vrednost pa je 1. value predstavlja napredek od 0 do max, zato ni nujno odstotek. Pri max = 8 in value = 3 so dokončane tri od osmih enot. Najmanjša vrednost je vedno 0; element progress ne podpira atributa min.
Ko je atribut value prisoten, je napredek določen. Lastnost position, ki je samo za branje, tedaj vrne value / max. Če atribut value ni prisoten, je napredek nedoločen: branje value vrne 0, position pa vrne -1. Dodelitev value = 0 pomeni znan ničelni napredek, ne nedoločenega stanja. Za vrnitev v to stanje uporabite removeAttribute("value").
Zagotovite dostopno ime s povezanim elementom label, atributom aria-label ali aria-labelledby; besedilo znotraj elementa ne nadomesti oznake. MDN vmesnik uvršča med široko dostopne v brskalnikih od julija 2015. Primer ustvari nepripet element ter pokaže razliko med znanim ničelnim in neznanim napredkom, brez animacij ali časovnih odvisnosti.
Primeri
(() => {
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.