CKTIS / HTML
onemptied — obrada pražnjenja medijskog resursa
Atribut onemptied određuje JavaScript koji se izvršava kada se dogodi događaj emptied. Kod zvuka i videa taj se događaj odnosi na ponovno postavljanje stanja medijskog resursa, a ne na uobičajeni završetak reprodukcije.
Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
onemptied="JavaScript statements"onemptied je HTML sadržajni atribut za obradu događaja emptied. Njegova vrijednost sadrži JavaScript naredbe; unutar obrađivača objekt događaja dostupan je kao event. To je globalni atribut za obradu događaja, ali prirodni izvori ovog događaja su elementi audio i video.
Preglednik pokreće emptied kada se stanje medijskog resursa ponovno postavi. Primjerice, load() stavlja ovaj događaj u red čekanja ako prethodni networkState nije bio NETWORK_EMPTY. Zato pozivanje load() na novom, praznom elementu ne jamči da će se događaj dogoditi. Nemojte brkati emptied s događajem ended, koji označava da je reprodukcija došla do kraja, ni s privremenim nedostatkom podataka za nastavak reprodukcije.
U JavaScriptu umjesto atributa možete dodijeliti funkciju svojstvu media.onemptied ili upotrijebiti media.addEventListener('emptied', handler). Naziv događaja nema prefiks on. Ponovna dodjela svojstva zamjenjuje prethodni obrađivač; addEventListener omogućuje registraciju neovisnih obrađivača. Pravilo CSP-a može blokirati kod u atributima za obradu događaja.
Primjer namjerno pokreće sintetički događaj emptied, pa mu nisu potrebni medijska datoteka ni pristup mreži. Očekivani vidljivi rezultat je emptied. Time se provjerava povezivanje obrađivača, a ne stvarno ponovno postavljanje resursa; pokretanje događaja ne mijenja stanje medija.
Primjeri
<!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>Rezultat
emptied
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.