KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

onplaying — gereedheid voor afspelen afhandelen

Het onplaying-attribuut bevat code voor het afhandelen van de gebeurtenis playing, die audio en video gebruiken wanneer afspelen kan beginnen of na een onderbreking kan worden hervat. Het start het afspelen niet en is niet hetzelfde als onplay.

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

Syntax

onplaying="JavaScript statements"
media.onplaying = (event) => { /* handler */ };

onplaying is een gebeurtenisafhandelingsattribuut voor playing. Het is als HTML-attribuut beschikbaar op alle HTML-elementen, maar wordt doorgaans gebruikt bij audio- en video-elementen. De waarde is JavaScript-code, geen bestandsadres of Booleaanse waarde.

De gebeurtenis playing geeft aan dat afspelen kan beginnen na een pauze of een vertraging door onvoldoende gegevens. play geeft daarentegen aan dat paused is veranderd in false. playing kan na buffering opnieuw optreden; het garandeert niet dat het afspelen ononderbroken doorgaat of dat er geluid hoorbaar is.

In JavaScript kun je een functie toewijzen aan media.onplaying; een volgende toewijzing vervangt de vorige functie voor die gebeurtenisafhandeling. Een alternatief is media.addEventListener('playing', handler). Een gebeurtenisafhandeling instellen start het afspelen niet vanzelf.

Het voorbeeld verstuurt een synthetische gebeurtenis playing om het attribuut zonder mediabestand te testen. De verwachte tekst is playing. Dit test geen daadwerkelijke weergave; scripts moeten zijn ingeschakeld en inline-gebeurtenisafhandelingen moeten zijn toegestaan.

Voorbeelden

<!doctype html>
<meta charset="utf-8">
<title>onplaying test</title>
<audio id="media" onplaying="document.getElementById('result').textContent = event.type"></audio>
<output id="result">pending</output>
<script>
  const media = document.getElementById('media');
  media.dispatchEvent(new Event('playing'));
</script>

Resultaat

playing

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