CKTIS / HTML
onemptied — das Leeren einer Medienressource behandeln
Das Attribut onemptied gibt JavaScript an, das ausgeführt wird, wenn ein emptied-Ereignis auftritt. Bei Audio und Video betrifft dieses Ereignis das Zurücksetzen des Zustands der Medienressource, nicht das normale Ende der Wiedergabe.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
onemptied="JavaScript statements"onemptied ist ein HTML-Event-Handler-Content-Attribut für das Ereignis emptied. Sein Wert enthält JavaScript-Anweisungen; innerhalb des Handlers ist das Ereignisobjekt als event verfügbar. Es ist ein globales Event-Handler-Attribut, doch die natürlichen Auslöser dieses Ereignisses sind audio- und video-Elemente.
Der Browser löst emptied aus, wenn der Zustand der Medienressource zurückgesetzt wird. Zum Beispiel stellt load() dieses Ereignis in die Warteschlange, wenn networkState zuvor nicht NETWORK_EMPTY war. Ein Aufruf von load() bei einem neuen, leeren Element garantiert daher kein Ereignis. Verwechsle emptied nicht mit ended, das das Erreichen des Wiedergabeendes anzeigt, oder mit einem vorübergehenden Mangel an Daten für die weitere Wiedergabe.
In JavaScript kannst du statt des Attributs eine Funktion media.onemptied zuweisen oder media.addEventListener('emptied', handler) verwenden. Der Ereignisname hat kein on-Präfix. Eine erneute Zuweisung der Eigenschaft ersetzt den vorherigen Handler; mit addEventListener lassen sich unabhängige Handler registrieren. Eine CSP-Richtlinie kann Code in Event-Handler-Attributen blockieren.
Das Beispiel löst absichtlich ein synthetisches emptied-Ereignis aus und benötigt daher weder eine Mediendatei noch Netzwerkzugriff. Die erwartete sichtbare Ausgabe ist emptied. Damit wird die Einbindung des Handlers getestet, nicht das tatsächliche Zurücksetzen einer Ressource; das Auslösen des Ereignisses ändert den Medienzustand nicht.
Beispiele
<!doctype html>
<meta charset="utf-8">
<title>onemptied</title>
<audio onemptied="document.getElementById('result').textContent = event.type;"></audio>
<output id="result">pending</output>
<script>
const media = document.querySelector('audio');
media.dispatchEvent(new Event('emptied'));
</script>Ergebnis
emptied
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.