CKTIS / HTML
onloadedmetadata — Verarbeitung geladener Medienmetadaten
Das Attribut onloadedmetadata enthält JavaScript zur Verarbeitung des Ereignisses loadedmetadata, meist bei audio oder video. Es signalisiert, dass Metadaten verfügbar sind, nicht dass der Download abgeschlossen oder eine unterbrechungsfreie Wiedergabe möglich ist.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
onloadedmetadata="JavaScript statements"onloadedmetadata ist ein HTML-Ereignisbehandlungsattribut für loadedmetadata. Sein Wert ist JavaScript-Code, kein Ereignisname und kein boolescher Wert. Es ist bei HTML-Elementen zulässig, wird aber typischerweise mit audio und video verwendet.
Der Browser löst loadedmetadata aus, wenn Metadaten für die geladene Ressource erstmals verfügbar sind: readyState erreicht mindestens HAVE_METADATA. Dann lassen sich duration und bei Videos auch videoWidth und videoHeight auslesen. duration kann Infinity sein, wenn die Ressource kein bekanntes Ende hat. Das bedeutet nicht, dass die ganze Datei heruntergeladen wurde; loadeddata betrifft die Verfügbarkeit der Daten des aktuellen Frames.
Im Attributcode bezeichnet event das Ereignis und this das Element. In JavaScript können Sie stattdessen dem Element media.onloadedmetadata eine Funktion zuweisen oder media.addEventListener('loadedmetadata', handler) verwenden. Der Ereignisname hat keinen on-Präfix. Eine Zuweisung an die Eigenschaft ersetzt die bisherige Funktion; addEventListener ermöglicht unabhängige Handler. Eine CSP-Richtlinie kann Code in Attributen blockieren.
Das Beispiel löst absichtlich ein synthetisches Ereignis aus, um den Attribut-Handler ohne Mediendatei zu testen. Es lädt weder Metadaten noch ändert es readyState. Bei echtem Laden von Medien registrieren Sie den Handler, bevor Sie den Abruf der Ressource starten.
Beispiele
<!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>Ergebnis
loadedmetadata handled
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.