KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

oncanplay — mediabeschikbaarheid voor afspelen afhandelen

Het oncanplay-attribuut bevat JavaScript dat wordt uitgevoerd bij de canplay-gebeurtenis. Voor audio en video geeft deze gebeurtenis aan dat afspelen kan beginnen of worden hervat, maar garandeert ze niet dat de volledige bron zonder onderbrekingen door buffering kan worden afgespeeld.

Versie: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

<audio oncanplay="handler(event)"></audio>
<video oncanplay="handler(event)"></video>

oncanplay is een event-handler-contentattribuut voor canplay. De waarde ervan is JavaScript-code; de handler heeft toegang tot het object event. Het attribuut is toegestaan op alle HTML-elementen, maar wordt meestal gebruikt om te reageren op de beschikbaarheid van audio- en video-elementen.

De browser activeert canplay wanneer de mediagereedheid van een lager niveau naar HAVE_FUTURE_DATA of hoger gaat. Er zijn dan gegevens beschikbaar om het afspelen voort te zetten, maar niet noodzakelijk genoeg om de volledige bron zonder buffering af te spelen. canplaythrough geeft daarentegen aan dat naar schatting afspelen tot het einde mogelijk is zonder te stoppen voor buffering. canplay betekent op zichzelf niet dat het afspelen al bezig is.

Gebruik in HTML oncanplay="handler(event)"; wijs in JavaScript een functie toe aan media.oncanplay of roep media.addEventListener('canplay', handler) aan. De gebeurtenisnaam bevat niet het voorvoegsel on. Het voorbeeld activeert een synthetische gebeurtenis: het controleert de koppeling tussen het attribuut en de handler, niet de daadwerkelijke mediagereedheid.

Voorbeelden

<!doctype html>
<meta charset="utf-8">
<title>oncanplay demo</title>
<audio id="media" oncanplay="document.getElementById('result').textContent = event.type"></audio>
<pre id="result">waiting</pre>
<script>
  const media = document.getElementById('media');
  media.dispatchEvent(new Event('canplay'));
</script>

Resultaat

canplay

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.

Bronnen