KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

onplay — het play-event afhandelen

Het attribuut onplay bevat JavaScript dat wordt uitgevoerd bij het play-event, meestal op een audio- of video-element. Dit event geeft aan dat de gepauzeerde toestand wordt verlaten, maar garandeert niet dat geluid of video al wordt afgespeeld.

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

Syntax

onplay="JavaScript statements"

onplay is een event-handler-contentattribuut voor play. De waarde is de body van een JavaScript-functie, geen bestandsadres of boolean attribuut. Het wordt meestal gebruikt op audio- en video-elementen; het toevoegen van het attribuut start de weergave niet.

De browser activeert play wanneer paused verandert van true naar false, bijvoorbeeld door play() of autoplay. Dat betekent nog niet dat er daadwerkelijk wordt afgespeeld: gegevens kunnen ontbreken. Het event playing, afgehandeld via onplaying, heeft betrekking op het starten of hervatten van de weergave nadat deze door onvoldoende gegevens is gestopt.

Wijs in JavaScript een functie toe aan media.onplay of gebruik media.addEventListener('play', handler). Een toewijzing aan de property vervangt de vorige functie voor die event-handlerplek. Content Security Policy kan code blokkeren die rechtstreeks in het attribuut staat.

Het voorbeeld verstuurt een synthetische play en heeft daarom geen mediabestand nodig. De verwachte tekst is play; hiermee wordt de koppeling van de handler getest, niet de weergave.

Voorbeelden

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onplay test</title>
<audio id="media" onplay="document.getElementById('result').textContent = event.type;"></audio>
<p id="result">pending</p>
<script>
  document.getElementById('media').dispatchEvent(new Event('play'));
</script>
</html>

Resultaat

play

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