CKTIS / HTML
onprogress — obsluha udalostí priebehu sťahovania
Atribút onprogress obsahuje JavaScript, ktorý obsluhuje udalosť progress. Pri prvkoch audio a video sa týka sťahovania multimediálnych dát, nie uplynutého času prehrávania.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
onprogress="JavaScript statements"
element.onprogress = handler;
element.addEventListener("progress", handler);onprogress je atribút obsluhy udalosti progress. Je dostupný na všetkých HTML prvkoch, ale jeho samotná prítomnosť nespúšťa sťahovanie ani nevytvára udalosti. Zodpovedajúca vlastnosť JavaScriptu je dostupná aj na objektoch Document a Window.
Pri prvkoch audio a video udalosť progress oznamuje sťahovanie multimediálnych dát. Neznamená priebeh prehrávania ani automaticky neposkytuje percento stiahnutých bajtov. Multimediálna udalosť používa rozhranie Event, nie ProgressEvent; nepredpokladajte, že sú dostupné loaded a total.
Hodnotou atribútu je kód JavaScriptu, v ktorom event odkazuje na udalosť. Prípadne priraďte funkciu k element.onprogress alebo použite element.addEventListener("progress", handler). Priradenie vlastnosti nahradí predchádzajúcu obsluhu v rámci tohto mechanizmu; addEventListener() umožňuje registrovať nezávislých poslucháčov.
Príklad výslovne odošle syntetickú udalosť progress, takže výsledok nezávisí od siete. Overuje obsluhu atribútu, nie skutočný priebeh sťahovania. Content Security Policy môže blokovať vložené obsluhy udalostí a vložené skripty.
Príklady
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onprogress demo</title>
<body>
<audio id="media" onprogress="document.getElementById('result').textContent = event.type"></audio>
<p id="result">waiting</p>
<script>
document.getElementById('media').dispatchEvent(new Event('progress'));
</script>
</body>
</html>Výsledok
progress
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.