KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

onended — het einde van het afspelen afhandelen

Het attribuut onended bevat JavaScript dat wordt uitgevoerd wanneer een ended-gebeurtenis wordt ontvangen. Bij audio- en video-elementen reageert het op het bereiken van het einde van de media, niet op het eenvoudigweg pauzeren van het afspelen.

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

Syntax

<audio onended="JavaScript statements"></audio>
<video onended="JavaScript statements"></video>

onended is een contentattribuut voor de gebeurtenisafhandelaar van ended. De waarde is de body van een JavaScript-functie, geen bestands-URL en ook niet alleen een functienaam. Je kunt event gebruiken om de gebeurtenis te bekijken.

Bij audio en video activeert de browser ended wanneer vooruit afspelen het einde van de media bereikt. Alleen pause() aanroepen betekent niet dat het afspelen is beëindigd. Als loop is ingesteld, gaat het afspelen bij het bereiken van het einde tijdens vooruit afspelen terug naar het begin in plaats van deze gebeurtenis te activeren.

Maak onderscheid tussen het HTML-attribuut onended, de JavaScript-eigenschap media.onended met een afhandelingsfunctie en de booleaanse status-eigenschap media.ended. Een alternatief voor het attribuut is media.addEventListener('ended', handler); de gebeurtenisnaam heeft geen voorvoegsel on.

Het voorbeeld activeert bewust een synthetische gebeurtenis en heeft daarom geen mediabestand nodig. Het controleert of de afhandelaar is gekoppeld, niet of het afspelen daadwerkelijk is afgelopen. Het beveiligingsbeleid van een pagina kan inline code voor gebeurtenisafhandelaars blokkeren.

Voorbeelden

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

Resultaat

ended

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