CKTIS / HTML
oncanplaythrough — spracovanie odhadovanej pripravenosti médií
Atribút oncanplaythrough obsahuje JavaScript, ktorý spracúva udalosť canplaythrough. Pri audiu a videu táto udalosť signalizuje odhadovanú možnosť prehrávať až do konca bez ďalšieho načítavania do vyrovnávacej pamäte, nezaručuje však neprerušované prehrávanie.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<audio oncanplaythrough="/* JavaScript */"></audio>
<video oncanplaythrough="/* JavaScript */"></video>oncanplaythrough je atribút obsluhy udalosti canplaythrough. Jeho hodnotou je kód JavaScriptu, nie boolovská hodnota. Zvyčajne sa používa pri prvkoch audio a video; kód obsluhy má prístup k objektu event.
Prehliadač zaradí udalosť canplaythrough do frontu, keď sa readyState zmení na HAVE_ENOUGH_DATA (4). Zvyčajne to znamená, že podľa odhadu môže prehrávanie pri aktuálnej hodnote playbackRate dosiahnuť koniec bez ďalšieho načítavania do vyrovnávacej pamäte. Tento stav zahŕňa aj situácie, keď dlhšie čakanie nemôže priniesť ďalšie údaje. Nie je to záruka ani potvrdenie, že sa stiahol celý súbor. canplay označuje nižšiu úroveň pripravenosti: možnosť spustiť alebo obnoviť prehrávanie.
Nezamieňajte názov atribútu oncanplaythrough s názvom udalosti canplaythrough. Alternatívou je priradiť funkciu vlastnosti element.oncanplaythrough alebo použiť element.addEventListener('canplaythrough', handler). Atribút obsahuje kód, kým vlastnosť dostáva funkciu.
Príklad zámerne vyvolá syntetickú udalosť, takže na overenie netreba mediálny súbor ani sieťové pripojenie. Očakávaný text odseku je canplaythrough; tento test overuje iba prepojenie obsluhy, nie skutočnú pripravenosť médií.
Príklady
<!doctype html>
<meta charset="utf-8">
<title>oncanplaythrough test</title>
<audio id="media" oncanplaythrough="document.getElementById('status').textContent = event.type"></audio>
<p id="status">Pending</p>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('canplaythrough'));
</script>Výsledok
canplaythrough
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.