CKTIS / HTML
onloadeddata — verfügbare Mediendaten behandeln
Das Attribut onloadeddata führt beim Ereignis loadeddata Code aus, sobald Daten für die aktuelle Audio- oder Videowiedergabeposition erstmals verfügbar sind. Das bedeutet weder, dass die gesamte Datei heruntergeladen wurde, noch dass die Wiedergabe begonnen hat.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<video onloadeddata="handleData(event)"></video>
<audio onloadeddata="handleData(event)"></audio>
media.onloadeddata = handleData;onloadeddata ist ein HTML-Ereignisbehandlungsattribut für loadeddata. Es ist auf HTML-Elementen verfügbar, wird aber vor allem mit audio und video verwendet. Sein Wert ist JavaScript-Code und kein boolescher Wert.
Der Browser löst loadeddata aus, sobald er während des Ladens erstmals Daten an der aktuellen Wiedergabeposition darstellen kann: readyState erreicht HAVE_CURRENT_DATA (2) oder einen höheren Zustand. Bei Video bedeutet dies, dass das aktuelle Bild verfügbar ist, nicht der gesamte Film. loadedmetadata betrifft Metadaten, während canplay anzeigt, dass die Wiedergabe zumindest ein Stück fortgesetzt werden kann. loadeddata selbst startet die Wiedergabe nicht.
Weisen Sie in JavaScript media.onloadeddata eine Funktion zu; eine spätere Zuweisung ersetzt den vorherigen Handler an dieser Stelle. Alternativ können Sie media.addEventListener('loadeddata', handler) verwenden. Der Ereignisname hat kein on-Präfix. Eine Content Security Policy kann Handler blockieren, die direkt in Attributen stehen.
Das Beispiel löst bewusst ein synthetisches Ereignis aus. Es prüft die Verbindung zwischen Attribut und Handler sowie die Textaktualisierung, nicht aber das Dekodieren oder die Bereitschaft der Medien.
Beispiele
<!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>Ergebnis
loadeddata
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.