CKTIS / HTML
onemptied — obsługa opróżnienia zasobu multimedialnego
Atrybut onemptied określa kod JavaScript wykonywany po zdarzeniu emptied. W przypadku audio i video zdarzenie to dotyczy wyzerowania stanu zasobu multimedialnego, a nie zwykłego zakończenia odtwarzania.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
onemptied="JavaScript statements"onemptied jest atrybutem HTML obsługującym zdarzenie emptied. Jego wartość zawiera instrukcje JavaScript; wewnątrz procedury obiekt zdarzenia jest dostępny jako event. Jest to globalny atrybut obsługi zdarzeń, ale naturalnym źródłem tego zdarzenia są elementy audio i video.
Przeglądarka emituje emptied, gdy stan zasobu multimedialnego zostaje wyzerowany. Na przykład load() kolejkuje to zdarzenie, jeśli wcześniejszy networkState nie był równy NETWORK_EMPTY. Samo wywołanie load() na nowym, pustym elemencie nie gwarantuje zdarzenia. Nie myl emptied z ended, które oznacza osiągnięcie końca odtwarzania, ani z chwilowym brakiem danych do dalszego odtwarzania.
W JavaScript można zamiast atrybutu przypisać funkcję do media.onemptied albo użyć media.addEventListener('emptied', handler). Nazwa zdarzenia nie zawiera przedrostka on. Kolejne przypisanie do właściwości zastępuje jej poprzednią procedurę; addEventListener pozwala rejestrować niezależne procedury. Polityka CSP może blokować kod w atrybutach zdarzeń.
Przykład celowo wysyła syntetyczne zdarzenie emptied, dzięki czemu nie wymaga pliku multimedialnego ani dostępu do sieci. Oczekiwany widoczny wynik to emptied. Sprawdza to podłączenie procedury, nie rzeczywiste opróżnienie zasobu; wysłanie zdarzenia nie zmienia stanu medium.
Przykłady
<!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>Wynik
emptied
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.