CKTIS / HTML
onplay — obrada događaja play
Atribut onplay sadrži JavaScript koji se izvršava pri događaju play, obično na elementu audio ili video. Taj događaj označava izlazak iz stanja pauze, ali ne jamči da se zvuk ili video već reproducira.
Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
onplay="JavaScript statements"onplay je sadržajni atribut za obradu događaja play. Njegova je vrijednost tijelo funkcije u JavaScriptu, a ne adresa datoteke ni booleov atribut. Obično se upotrebljava na elementima audio i video; dodavanje atributa ne pokreće reprodukciju.
Preglednik pokreće play kada se paused promijeni iz true u false, primjerice putem play() ili autoplay. To još ne znači da se reprodukcija doista odvija: podaci možda nisu dostupni. Događaj playing, obrađen putem onplaying, odnosi se na početak ili nastavak reprodukcije nakon zaustavljanja zbog nedostatka podataka.
U JavaScriptu dodijelite funkciju svojstvu media.onplay ili upotrijebite media.addEventListener('play', handler). Dodjela svojstvu zamjenjuje prethodnu funkciju za to mjesto obrade događaja. Content Security Policy može blokirati kôd zapisan izravno u atributu.
Primjer šalje sintetički play, pa mu nije potrebna medijska datoteka. Očekivani tekst je play; time se provjerava povezivanje obrađivača, a ne reprodukcija.
Primjeri
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onplay test</title>
<audio id="media" onplay="document.getElementById('result').textContent = event.type;"></audio>
<p id="result">pending</p>
<script>
document.getElementById('media').dispatchEvent(new Event('play'));
</script>
</html>Rezultat
play
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.