CKTIS / HTML
onprogress — gebeurtenissen voor downloadvoortgang afhandelen
Het onprogress-attribuut bevat JavaScript dat de progress-gebeurtenis afhandelt. Bij audio- en video-elementen heeft deze gebeurtenis betrekking op het downloaden van mediagegevens, niet op de verstreken afspeeltijd.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
onprogress="JavaScript statements"
element.onprogress = handler;
element.addEventListener("progress", handler);onprogress is een attribuut voor het afhandelen van de gebeurtenis progress. Het is beschikbaar op alle HTML-elementen, maar alleen de aanwezigheid ervan start geen downloads en genereert geen gebeurtenissen. De bijbehorende JavaScript-eigenschap is ook beschikbaar op Document- en Window-objecten.
Bij audio en video meldt progress dat mediagegevens worden gedownload. Het betekent niet dat de weergave vordert en levert niet automatisch een percentage van de gedownloade bytes. De media-gebeurtenis gebruikt de interface Event, niet ProgressEvent; ga er niet van uit dat loaded en total beschikbaar zijn.
De attribuutwaarde is JavaScript-code, waarin event naar de gebeurtenis verwijst. Je kunt ook een functie toewijzen aan element.onprogress of element.addEventListener("progress", handler) gebruiken. Toewijzing aan de eigenschap vervangt de vorige handler voor dat mechanisme; met addEventListener() kun je onafhankelijke luisteraars registreren.
Het voorbeeld verstuurt expliciet een synthetische progress-gebeurtenis, dus het resultaat is niet afhankelijk van het netwerk. Het test de afhandeling van het attribuut, niet de daadwerkelijke downloadvoortgang. Content Security Policy kan inline-eventhandlers en inline-scripts blokkeren.
Voorbeelden
<!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>Resultaat
progress
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.