CKTIS / HTML
onpause — gebeurtenishandler voor het pauzeren van media
Het attribuut onpause bevat JavaScript dat de gebeurtenis pause afhandelt, meestal op een audio- of video-element. Het reageert wanneer het afspelen wordt gepauzeerd, maar pauzeert het afspelen niet zelf.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<audio onpause="handlerCode"></audio>
<video onpause="handlerCode"></video>
media.onpause = handler;
media.addEventListener("pause", handler);onpause is een globaal attribuut voor het afhandelen van de gebeurtenis pause. Hoewel het beschikbaar is op alle HTML-elementen, wordt het meestal gebruikt voor het afhandelen van pauzes op audio- en video-elementen. De waarde is JavaScript-code, geen booleaanse waarde.
Bij het normaal pauzeren van media wordt paused true en wordt de gebeurtenis in een wachtrijtaak verzonden. Als je pause() aanroept op een element dat al gepauzeerd is, ontstaat er geen nieuwe pause-gebeurtenis. De gebeurtenis bubbelt niet en kan niet worden geannuleerd; return false voorkomt het pauzeren niet.
In attribuutcode staat event voor de gebeurtenis en verwijst this naar het element. De JavaScript-eigenschap media.onpause accepteert een functie of null; een nieuwe toewijzing vervangt de vorige functie. Met media.addEventListener("pause", handler) kun je onafhankelijke handlers registreren. Een CSP-beleid kan attribuutcode blokkeren.
Het voorbeeld verzendt een synthetische pause-gebeurtenis om de koppeling van het attribuut te controleren zonder mediabestand. De verwachte tekst is pause. Deze test start of pauzeert het afspelen niet en controleert geen echte statusovergang van de media.
Voorbeelden
<!doctype html>
<meta charset="utf-8">
<title>onpause test</title>
<audio id="media" onpause="document.getElementById('result').textContent = event.type"></audio>
<output id="result">pending</output>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('pause'));
</script>Resultaat
pause
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.