CKTIS / HTML
onplay — obravnava dogodka play
Atribut onplay vsebuje JavaScript, ki se izvede ob dogodku play, običajno na elementu audio ali video. Dogodek označuje izhod iz stanja premora, ne zagotavlja pa, da se zvok ali video že predvaja.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
onplay="JavaScript statements"onplay je vsebinski atribut za obravnavo dogodka play. Njegova vrednost je telo funkcije JavaScript, ne naslov datoteke ali logični atribut. Običajno se uporablja na elementih audio in video; dodajanje atributa ne zažene predvajanja.
Brskalnik sproži play, ko se paused spremeni iz true v false, na primer zaradi play() ali autoplay. To še ne pomeni, da predvajanje dejansko poteka: podatki morda niso na voljo. Dogodek playing, obravnavan z onplaying, se nanaša na začetek ali nadaljevanje predvajanja po ustavitvi zaradi pomanjkanja podatkov.
V JavaScriptu funkcijo dodelite lastnosti media.onplay ali uporabite media.addEventListener('play', handler). Dodelitev lastnosti nadomesti prejšnjo funkcijo v tem mestu za obravnavo dogodka. Content Security Policy lahko blokira kodo, zapisano neposredno v atribut.
Primer sproži sintetični play, zato ne potrebuje večpredstavnostne datoteke. Pričakovano besedilo je play; s tem se preveri povezava obravnavalnika, ne predvajanje.
Primeri
<!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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.