Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / HTML

onemptied — obravnava izpraznitev predstavnega vira

Atribut onemptied določa kodo JavaScript, ki se izvede ob dogodku emptied. Pri zvoku in videu se ta dogodek nanaša na ponastavitev stanja predstavnega vira, ne pa na običajen konec predvajanja.

Različica: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaksa

onemptied="JavaScript statements"

onemptied je vsebinski atribut HTML za obravnavo dogodka emptied. Njegova vrednost vsebuje stavke JavaScript; znotraj obravnavalnika je objekt dogodka na voljo kot event. Gre za globalni atribut za obravnavo dogodkov, vendar sta naravna vira tega dogodka elementa audio in video.

Brskalnik sproži emptied, ko se ponastavi stanje predstavnega vira. Na primer, load() uvrsti ta dogodek v čakalno vrsto, če prejšnji networkState ni bil NETWORK_EMPTY. Klic load() na novem, praznem elementu zato ne zagotavlja dogodka. Ne zamenjujte emptied z ended, ki označuje, da je predvajanje doseglo konec, ali z začasnim pomanjkanjem podatkov za nadaljevanje predvajanja.

V JavaScriptu lahko namesto atributa funkcijo dodelite media.onemptied ali uporabite media.addEventListener('emptied', handler). Ime dogodka nima predpone on. Ponovna dodelitev lastnosti zamenja prejšnji obravnavalnik; addEventListener omogoča registracijo neodvisnih obravnavalnikov. Pravilnik CSP lahko blokira kodo v atributih za obravnavo dogodkov.

Primer namenoma sproži sintetični dogodek emptied, zato ne potrebuje predstavne datoteke ali dostopa do omrežja. Pričakovani vidni izhod je emptied. S tem preveri povezavo obravnavalnika, ne pa dejanske ponastavitve vira; sprožitev dogodka ne spremeni stanja predstavnega vira.

Primeri

<!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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri