CKTIS / HTML
onloadeddata — beschikbare mediagegevens afhandelen
Het kenmerk onloadeddata voert code uit bij het loadeddata-gebeurtenis, zodra gegevens voor de huidige afspeelpositie van audio of video voor het eerst beschikbaar zijn. Dit betekent niet dat het hele bestand is gedownload of dat het afspelen is begonnen.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<video onloadeddata="handleData(event)"></video>
<audio onloadeddata="handleData(event)"></audio>
media.onloadeddata = handleData;onloadeddata is een HTML-gebeurtenisafhandelingsattribuut voor loadeddata. Het is beschikbaar op HTML-elementen, maar wordt vooral gebruikt met audio en video. De waarde is JavaScript-code, geen Booleaanse waarde.
De browser activeert loadeddata zodra deze tijdens het laden voor het eerst gegevens op de huidige afspeelpositie kan weergeven: readyState bereikt HAVE_CURRENT_DATA (2) of een hogere status. Bij video betekent dit dat het huidige beeld beschikbaar is, niet de hele film. loadedmetadata betreft metadata, terwijl canplay aangeeft dat het afspelen ten minste een stukje verder kan. loadeddata start het afspelen zelf niet.
Wijs in JavaScript een functie toe aan media.onloadeddata; een latere toewijzing vervangt de vorige handler op die plek. Je kunt ook media.addEventListener('loadeddata', handler) gebruiken. De gebeurtenisnaam heeft geen on-prefix. Content Security Policy kan handlers blokkeren die rechtstreeks in attributen zijn geschreven.
Het voorbeeld activeert bewust een synthetische gebeurtenis. Het test de koppeling tussen attribuut en handler en de tekstupdate, maar test niet het decoderen of de gereedheid van media.
Voorbeelden
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onloadeddata demo</title>
<audio id="media" onloadeddata="document.getElementById('result').textContent = event.type"></audio>
<p id="result">waiting</p>
<script>
// Synthetic event: tests the handler, not media loading.
document.getElementById('media').dispatchEvent(new Event('loadeddata'));
</script>
</html>Resultaat
loadeddata
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.