CKTIS / HTML
onpause — obsluha udalosti pozastavenia médií
Atribút onpause obsahuje JavaScript, ktorý obsluhuje udalosť pause, zvyčajne na prvku audio alebo video. Reaguje na pozastavenie prehrávania, ale sám prehrávanie nepozastaví.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<audio onpause="handlerCode"></audio>
<video onpause="handlerCode"></video>
media.onpause = handler;
media.addEventListener("pause", handler);onpause je globálny atribút na obsluhu udalosti pause. Je dostupný na všetkých prvkoch HTML, ale zvyčajne sa používa na obsluhu pozastavenia prvkov audio a video. Jeho hodnotou je kód JavaScriptu, nie logická hodnota.
Pri bežnom pozastavení média sa paused nastaví na true a udalosť sa odošle v úlohe zaradenej do frontu. Volanie pause() na už pozastavenom prvku nevyvolá ďalšiu udalosť pause. Udalosť sa nešíri nahor a nedá sa zrušiť; return false pozastaveniu nezabráni.
V kóde atribútu označuje event udalosť a this odkazuje na prvok. Vlastnosť JavaScriptu media.onpause prijíma funkciu alebo null; nové priradenie nahradí predchádzajúcu funkciu. Pomocou media.addEventListener("pause", handler) možno registrovať nezávislé obslužné funkcie. Politika CSP môže blokovať kód atribútov.
Príklad odošle syntetickú udalosť pause, aby overil zapojenie atribútu bez mediálneho súboru. Očakávaný text je pause. Tento test nespustí ani nepozastaví prehrávanie a neoveruje skutočnú zmenu stavu média.
Príklady
<!doctype html>
<meta charset="utf-8">
<title>onpause test</title>
<audio id="media" onpause="document.getElementById('result').textContent = event.type"></audio>
<output id="result">pending</output>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('pause'));
</script>Výsledok
pause
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.