CKTIS / HTML
onemptied — zpracování vyprázdnění mediálního zdroje
Atribut onemptied určuje JavaScript, který se spustí při události emptied. U zvuku a videa se tato událost týká resetování stavu mediálního zdroje, nikoli běžného dokončení přehrávání.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
onemptied="JavaScript statements"onemptied je obsahový atribut HTML pro obsluhu události emptied. Jeho hodnota obsahuje příkazy JavaScriptu; uvnitř obslužné funkce je objekt události dostupný jako event. Jde o globální atribut pro obsluhu událostí, ale přirozeným zdrojem této události jsou prvky audio a video.
Prohlížeč vyvolá emptied, když se resetuje stav mediálního zdroje. Například load() zařadí tuto událost do fronty, pokud předchozí networkState nebyl NETWORK_EMPTY. Zavolání load() na novém prázdném prvku proto výskyt události nezaručuje. Nezaměňujte emptied s ended, která označuje dosažení konce přehrávání, ani s dočasným nedostatkem dat pro pokračování přehrávání.
V JavaScriptu můžete místo atributu přiřadit funkci k media.onemptied nebo použít media.addEventListener('emptied', handler). Název události nemá předponu on. Opětovné přiřazení vlastnosti nahradí předchozí obslužnou funkci; addEventListener umožňuje registrovat nezávislé obslužné funkce. Zásady CSP mohou blokovat kód v atributech pro obsluhu událostí.
Příklad záměrně vyvolává syntetickou událost emptied, takže nepotřebuje mediální soubor ani přístup k síti. Očekávaný viditelný výstup je emptied. Ověřuje se tím zapojení obslužné funkce, nikoli skutečné resetování zdroje; vyvolání události stav média nezmění.
Pří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ýsledek
emptied
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.