Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje