CKTIS / HTML
onloadedmetadata — het laden van media-metagegevens afhandelen
Het kenmerk onloadedmetadata bevat JavaScript voor het afhandelen van de gebeurtenis loadedmetadata, meestal bij audio of video. Het geeft aan dat metagegevens beschikbaar zijn, niet dat het downloaden is voltooid of dat ononderbroken afspelen mogelijk is.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
onloadedmetadata="JavaScript statements"onloadedmetadata is een HTML-gebeurtenisafhandelingskenmerk voor loadedmetadata. De waarde is JavaScript-code, geen gebeurtenisnaam of booleaanse waarde. Het is toegestaan op HTML-elementen, maar wordt meestal gebruikt bij audio en video.
De browser activeert loadedmetadata zodra metagegevens van de resource die wordt geladen voor het eerst beschikbaar zijn: readyState bereikt minstens HAVE_METADATA. Daarna kunt u duration uitlezen en, bij video, ook videoWidth en videoHeight. duration kan Infinity zijn als de resource geen bekend einde heeft. Dit betekent niet dat het hele bestand is gedownload; loadeddata gaat over de beschikbaarheid van gegevens voor het huidige frame.
In de attribuutcode verwijst event naar de gebeurtenis en this naar het element. In JavaScript kunt u in plaats daarvan een functie toewijzen aan media.onloadedmetadata of media.addEventListener('loadedmetadata', handler) gebruiken. De gebeurtenisnaam heeft geen voorvoegsel on. Een toewijzing aan de eigenschap vervangt de vorige functie; met addEventListener kunt u onafhankelijke handlers toevoegen. Een CSP-beleid kan code in kenmerken blokkeren.
Het voorbeeld activeert bewust een synthetische gebeurtenis om het kenmerk zonder mediabestand te testen. Het laadt geen metagegevens en wijzigt readyState niet. Registreer bij het werkelijk laden van media de handler voordat u begint de resource op te halen.
Voorbeelden
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onloadedmetadata demo</title>
<audio id="media" onloadedmetadata="document.getElementById('result').textContent = event.type + ' handled'"></audio>
<p id="result">Waiting</p>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('loadedmetadata'));
</script>
</html>Resultaat
loadedmetadata handled
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.