CKTIS / HTML
onemptied — het leegmaken van een mediabron afhandelen
Het attribuut onemptied geeft aan welke JavaScript-code wordt uitgevoerd wanneer een emptied-gebeurtenis plaatsvindt. Bij audio en video heeft deze gebeurtenis betrekking op het resetten van de status van de mediabron, niet op het gewone einde van de weergave.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
onemptied="JavaScript statements"onemptied is een HTML-contentattribuut voor de gebeurtenishandler van de gebeurtenis emptied. De waarde bevat JavaScript-instructies; binnen de handler is het gebeurtenisobject beschikbaar als event. Het is een globale gebeurtenishandlerattribuut, maar audio- en video-elementen zijn de voor de hand liggende bronnen van deze gebeurtenis.
De browser activeert emptied wanneer de status van de mediabron wordt gereset. load() zet deze gebeurtenis bijvoorbeeld in de wachtrij als de vorige networkState niet NETWORK_EMPTY was. load() aanroepen op een nieuw, leeg element garandeert dus niet dat er een gebeurtenis plaatsvindt. Verwar emptied niet met ended, dat aangeeft dat het einde van de weergave is bereikt, of met een tijdelijk gebrek aan gegevens om de weergave voort te zetten.
In JavaScript kun je in plaats van het attribuut een functie toewijzen aan media.onemptied of media.addEventListener('emptied', handler) gebruiken. De gebeurtenisnaam heeft geen on-voorvoegsel. Een nieuwe toewijzing aan de eigenschap vervangt de vorige handler; met addEventListener kun je onafhankelijke handlers registreren. Een CSP-beleid kan code in gebeurtenishandlerattributen blokkeren.
Het voorbeeld activeert bewust een synthetische emptied-gebeurtenis en heeft daarom geen mediabestand of netwerktoegang nodig. De verwachte zichtbare uitvoer is emptied. Hiermee wordt getest of de handler is gekoppeld, niet of een bron daadwerkelijk is gereset; het activeren van de gebeurtenis verandert de mediastatus niet.
Voorbeelden
<!doctype html>
<meta charset="utf-8">
<title>onemptied</title>
<audio onemptied="document.getElementById('result').textContent = event.type;"></audio>
<output id="result">pending</output>
<script>
const media = document.querySelector('audio');
media.dispatchEvent(new Event('emptied'));
</script>Resultaat
emptied
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.