Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje