Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje