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

CKTIS / HTML

onloadeddata — zpracování dostupných mediálních dat

Atribut onloadeddata spustí kód při události loadeddata, jakmile jsou poprvé dostupná data pro aktuální pozici přehrávání zvuku nebo videa. Neznamená to, že se stáhl celý soubor nebo že začalo přehrávání.

Verze: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

<video onloadeddata="handleData(event)"></video>
<audio onloadeddata="handleData(event)"></audio>
media.onloadeddata = handleData;

onloadeddata je atribut HTML pro obsluhu události loadeddata. Je dostupný na prvcích HTML, používá se však především s audio a video. Jeho hodnotou je kód JavaScriptu, nikoli logická hodnota.

Prohlížeč vyvolá loadeddata, jakmile může během načítání poprvé zobrazit data na aktuální pozici přehrávání: readyState dosáhne HAVE_CURRENT_DATA (2) nebo vyššího stavu. U videa to znamená, že je dostupný aktuální snímek, nikoli celý film. loadedmetadata se týká metadat, zatímco canplay označuje, že přehrávání může pokračovat alespoň o kousek. Samotná událost loadeddata přehrávání nespustí.

V JavaScriptu přiřaďte funkci k media.onloadeddata; další přiřazení nahradí předchozí obsluhu na tomto místě. Alternativně použijte media.addEventListener('loadeddata', handler). Název události nemá předponu on. Content Security Policy může blokovat obsluhy zapsané přímo v atributech.

Příklad záměrně vyvolává syntetickou událost. Ověřuje propojení atributu s obsluhou a změnu textu, neověřuje však dekódování ani připravenost média.

Příklady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onloadeddata demo</title>
<audio id="media" onloadeddata="document.getElementById('result').textContent = event.type"></audio>
<p id="result">waiting</p>
<script>
  // Synthetic event: tests the handler, not media loading.
  document.getElementById('media').dispatchEvent(new Event('loadeddata'));
</script>
</html>

Výsledek

loadeddata

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