CKTIS / HTML
onprogress — obsluha událostí průběhu stahování
Atribut onprogress obsahuje JavaScript, který obsluhuje událost progress. U prvků audio a video se týká stahování multimediálních dat, nikoli uplynulého času přehrávání.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
onprogress="JavaScript statements"
element.onprogress = handler;
element.addEventListener("progress", handler);onprogress je atribut obsluhy události progress. Je dostupný na všech HTML prvcích, ale jeho samotná přítomnost nespouští stahování ani nevytváří události. Odpovídající vlastnost JavaScriptu je dostupná také na objektech Document a Window.
U prvků audio a video událost progress oznamuje stahování multimediálních dat. Neznamená průběh přehrávání ani automaticky neposkytuje procento stažených bajtů. Multimediální událost používá rozhraní Event, nikoli ProgressEvent; nepředpokládejte, že jsou dostupné loaded a total.
Hodnotou atributu je kód JavaScriptu, ve kterém event odkazuje na událost. Případně přiřaďte funkci k element.onprogress nebo použijte element.addEventListener("progress", handler). Přiřazení vlastnosti nahradí předchozí obsluhu v rámci tohoto mechanismu; addEventListener() umožňuje registrovat nezávislé posluchače.
Příklad výslovně odešle syntetickou událost progress, takže výsledek nezávisí na síti. Ověřuje obsluhu atributu, nikoli skutečný průběh stahování. Content Security Policy může blokovat vložené obsluhy událostí a vložené skripty.
Pří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ýsledek
progress
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.