CKTIS / HTML
onpause — obravnavalnik dogodka za premor predstavnosti
Atribut onpause vsebuje JavaScript, ki obravnava dogodek pause, običajno na elementu audio ali video. Odzove se na premor predvajanja, vendar predvajanja ne ustavi sam.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<audio onpause="handlerCode"></audio>
<video onpause="handlerCode"></video>
media.onpause = handler;
media.addEventListener("pause", handler);onpause je globalni atribut za obravnavo dogodka pause. Čeprav je na voljo na vseh elementih HTML, se običajno uporablja za obravnavo premora na elementih audio in video. Njegova vrednost je koda JavaScript, ne logična vrednost.
Pri običajnem premoru predstavnosti postane paused enak true, dogodek pa se sproži v opravilu, dodanem v čakalno vrsto. Klic pause() na že ustavljenem elementu ne sproži novega dogodka pause. Dogodek se ne širi navzgor in ga ni mogoče preklicati; return false premora ne prepreči.
V kodi atributa event predstavlja dogodek, this pa se nanaša na element. Lastnost JavaScript media.onpause sprejme funkcijo ali null; nova dodelitev zamenja prejšnjo funkcijo. media.addEventListener("pause", handler) omogoča registracijo neodvisnih obravnavalnikov. Pravilnik CSP lahko blokira kodo atributov.
Primer sproži sintetični dogodek pause, da preveri povezavo atributa brez predstavnostne datoteke. Pričakovano besedilo je pause. Ta preizkus ne zažene ali ustavi predvajanja in ne preverja dejanske spremembe stanja predstavnosti.
Primeri
<!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>Rezultat
pause
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.