CKTIS / HTML
oncanplay – spracovanie pripravenosti médií na prehrávanie
Atribút oncanplay obsahuje JavaScript, ktorý sa spustí pri udalosti canplay. Pri zvuku a videu signalizuje, že prehrávanie možno spustiť alebo obnoviť, nezaručuje však, že sa celý zdroj prehrá bez prerušení spôsobených načítavaním do vyrovnávacej pamäte.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<audio oncanplay="handler(event)"></audio>
<video oncanplay="handler(event)"></video>oncanplay je obsahový atribút obsluhy udalosti canplay. Jeho hodnotou je kód JavaScriptu; obsluha má prístup k objektu event. Atribút je povolený na všetkých prvkoch HTML, zvyčajne sa však používa na reakciu na pripravenosť prvkov audio a video.
Prehliadač vyvolá canplay, keď sa stav pripravenosti média zmení z nižšej úrovne na HAVE_FUTURE_DATA alebo vyššiu. K dispozícii sú potom údaje umožňujúce pokračovať v prehrávaní, no nemusia stačiť na prehratie celého zdroja bez načítavania do vyrovnávacej pamäte. canplaythrough naopak označuje odhad, že možno prehrať celý zdroj až do konca bez zastavenia pre načítavanie do vyrovnávacej pamäte. Samotné canplay neznamená, že prehrávanie už prebieha.
V HTML použite oncanplay="handler(event)"; v JavaScripte priraďte funkciu k media.oncanplay alebo zavolajte media.addEventListener('canplay', handler). Názov udalosti neobsahuje predponu on. Príklad vyvolá syntetickú udalosť: overuje prepojenie atribútu s jeho obsluhou, nie skutočnú pripravenosť média.
Prí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ýsledok
canplay
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.