CKTIS / HTML
onpause — rukovatelj događajem pauziranja medija
Atribut onpause sadrži JavaScript koji obrađuje događaj pause, obično na elementu audio ili video. Reagira na pauziranje reprodukcije, ali sam ne pauzira reprodukciju.
Verzija: 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 obradu događaja pause. Iako je dostupan na svim HTML elementima, obično se upotrebljava za obradu pauziranja elemenata audio i video. Njegova je vrijednost JavaScript kod, a ne Booleova vrijednost.
Pri uobičajenom pauziranju medija paused postaje true, a događaj se šalje u zadatku stavljenom u red čekanja. Poziv pause() na elementu koji je već pauziran ne stvara novi događaj pause. Događaj se ne širi prema gore i ne može se otkazati; return false neće spriječiti pauziranje.
U kodu atributa event predstavlja događaj, a this upućuje na element. Svojstvo JavaScripta media.onpause prihvaća funkciju ili null; nova dodjela zamjenjuje prethodnu funkciju. media.addEventListener("pause", handler) omogućuje registraciju neovisnih rukovatelja. Pravilo CSP-a može blokirati kod atributa.
Primjer šalje sintetički događaj pause kako bi provjerio povezivanje atributa bez medijske datoteke. Očekivani tekst je pause. Ovaj test ne pokreće ni pauzira reprodukciju i ne provjerava stvarnu promjenu stanja medija.
Primjeri
<!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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.