CKTIS / HTML
onwaiting — wachten op mediagegevens afhandelen
Het attribuut onwaiting bepaalt welke code wordt uitgevoerd bij de waiting-gebeurtenis. Bij audio- en video-elementen geeft deze gebeurtenis aan dat het afspelen niet verder kan doordat er onvoldoende gegevens beschikbaar zijn. Het attribuut zelf start geen download of afspelen.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
onwaiting="JavaScript statements"
media.onwaiting = (event) => { /* handle waiting */ };onwaiting is het gebeurtenisafhandelingsattribuut voor waiting. De HTML-waarde is JavaScript-code, geen booleaanse waarde. Het is beschikbaar op alle HTML-elementen, maar wordt meestal gebruikt bij audio- en video-elementen. De JavaScript-tegenhanger is de eigenschap onwaiting.
De gebeurtenis waiting geeft aan dat het afspelen niet verder kan omdat de gegevens voor de volgende stap niet beschikbaar zijn. Dit kan gebeuren wanneer het afspelen begint of nadat de buffer leeg is geraakt. Op zichzelf betekent dit niet dat er een permanente fout is of dat de netwerkverbinding is verbroken. Verwar dit niet met stalled, dat gaat over gegevens die niet binnenkomen terwijl de browser ze probeert op te halen.
Een handler kan een wachtindicator weergeven; met de gebeurtenis playing kun je reageren wanneer het afspelen begint of wordt hervat. Een natuurlijke waiting-gebeurtenis bubbelt niet en kan niet worden geannuleerd, dus return false hervat het afspelen niet. Een functie toewijzen aan media.onwaiting vervangt de eerdere handler van die eigenschap; met addEventListener('waiting', handler) kunnen onafhankelijke listeners worden geregistreerd.
Het voorbeeld verstuurt bewust een synthetische gebeurtenis, zodat het resultaat niet afhankelijk is van een mediabestand of het netwerk. De alinea hoort te veranderen van idle in waiting. Dit test alleen of de handler is gekoppeld: het veroorzaakt geen echte buffering en verandert de afspeelstatus niet. Het beveiligingsbeleid van een pagina kan inline scripts en inline gebeurtenishandlers blokkeren.
Voorbeelden
<!doctype html>
<meta charset="utf-8">
<title>onwaiting demo</title>
<video id="media" onwaiting="document.getElementById('status').textContent = event.type"></video>
<p id="status">idle</p>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('waiting'));
</script>Resultaat
waiting
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.