CKTIS / HTML
onemptied — spracovanie vyprázdnenia mediálneho zdroja
Atribút onemptied určuje JavaScript, ktorý sa vykoná pri udalosti emptied. Pri zvuku a videu sa táto udalosť týka resetovania stavu mediálneho zdroja, nie bežného ukončenia prehrávania.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
onemptied="JavaScript statements"onemptied je obsahový atribút HTML na obsluhu udalosti emptied. Jeho hodnota obsahuje príkazy JavaScriptu; v obslužnej funkcii je objekt udalosti dostupný ako event. Je to globálny atribút na obsluhu udalostí, no prirodzeným zdrojom tejto udalosti sú prvky audio a video.
Prehliadač vyvolá emptied, keď sa resetuje stav mediálneho zdroja. Napríklad load() zaradí túto udalosť do frontu, ak predchádzajúci networkState nebol NETWORK_EMPTY. Zavolanie load() na novom prázdnom prvku preto výskyt udalosti nezaručuje. Nezamieňajte emptied s ended, ktorá označuje dosiahnutie konca prehrávania, ani s dočasným nedostatkom údajov na pokračovanie prehrávania.
V JavaScripte môžete namiesto atribútu priradiť funkciu k media.onemptied alebo použiť media.addEventListener('emptied', handler). Názov udalosti nemá predponu on. Opätovné priradenie vlastnosti nahradí predchádzajúcu obslužnú funkciu; addEventListener umožňuje registrovať nezávislé obslužné funkcie. Zásady CSP môžu blokovať kód v atribútoch na obsluhu udalostí.
Príklad zámerne vyvoláva syntetickú udalosť emptied, preto nepotrebuje mediálny súbor ani prístup k sieti. Očakávaný viditeľný výstup je emptied. Testuje sa tým zapojenie obslužnej funkcie, nie skutočné resetovanie zdroja; vyvolanie udalosti stav média nezmení.
Príklady
<!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>Výsledok
emptied
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.