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

CKTIS / HTML

oncanplay – zpracování připravenosti médií k přehrávání

Atribut oncanplay obsahuje JavaScript, který se spustí při události canplay. U zvuku a videa tato událost signalizuje, že lze přehrávání zahájit nebo obnovit, nezaručuje však, že se celý zdroj přehraje bez přerušení kvůli načítání do vyrovnávací paměti.

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

Syntaxe

<audio oncanplay="handler(event)"></audio>
<video oncanplay="handler(event)"></video>

oncanplay je obsahový atribut obsluhy události canplay. Jeho hodnotou je kód JavaScriptu; obsluha má přístup k objektu event. Atribut je povolen u všech prvků HTML, obvykle se však používá k reakci na připravenost prvků audio a video.

Prohlížeč vyvolá canplay, když se stav připravenosti média změní z nižší úrovně na HAVE_FUTURE_DATA nebo vyšší. Jsou pak k dispozici data umožňující pokračovat v přehrávání, ale nemusí jich být dost pro přehrání celého zdroje bez načítání do vyrovnávací paměti. Naproti tomu canplaythrough označuje odhad, že lze přehrát celý zdroj až do konce bez zastavení kvůli načítání do vyrovnávací paměti. Samotné canplay neznamená, že přehrávání již probíhá.

V HTML použijte oncanplay="handler(event)"; v JavaScriptu přiřaďte funkci k media.oncanplay nebo zavolejte media.addEventListener('canplay', handler). Název události neobsahuje předponu on. Příklad vyvolá syntetickou událost: ověřuje propojení atributu s jeho obsluhou, nikoli skutečnou připravenost média.

Příklady

<!doctype html>
<meta charset="utf-8">
<title>oncanplay demo</title>
<audio id="media" oncanplay="document.getElementById('result').textContent = event.type"></audio>
<pre id="result">waiting</pre>
<script>
  const media = document.getElementById('media');
  media.dispatchEvent(new Event('canplay'));
</script>

Výsledek

canplay

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