Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / HTML

oncanplay – obravnava pripravljenosti medijev za predvajanje

Atribut oncanplay vsebuje JavaScript, ki se izvede ob dogodku canplay. Pri zvoku in videu ta dogodek označuje, da se predvajanje lahko začne ali nadaljuje, ne zagotavlja pa, da bo mogoče celoten vir predvajati brez prekinitev zaradi medpomnjenja.

Različica: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaksa

<audio oncanplay="handler(event)"></audio>
<video oncanplay="handler(event)"></video>

oncanplay je vsebinski atribut za obravnavo dogodka canplay. Njegova vrednost je koda JavaScript; obravnavalnik ima dostop do objekta event. Atribut je dovoljen na vseh elementih HTML, vendar se običajno uporablja za odzivanje na pripravljenost elementov audio in video.

Brskalnik sproži canplay, ko se stanje pripravljenosti medija z nižje ravni spremeni na HAVE_FUTURE_DATA ali višjo. Na voljo so torej podatki, ki omogočajo nadaljevanje predvajanja, vendar jih ni nujno dovolj za predvajanje celotnega vira brez medpomnjenja. canplaythrough pa označuje oceno, da je mogoče predvajati do konca brez ustavljanja zaradi medpomnjenja. Sam canplay ne pomeni, da predvajanje že poteka.

V HTML uporabite oncanplay="handler(event)"; v JavaScriptu funkcijo dodelite media.oncanplay ali pokličite media.addEventListener('canplay', handler). Ime dogodka ne vključuje predpone on. Primer sproži sintetični dogodek: preveri povezavo med atributom in njegovim obravnavalnikom, ne pa dejanske pripravljenosti medija.

Primeri

<!doctype html>
<meta charset="utf-8">
<title>oncanplay demo</title>
<audio id="media" oncanplay="document.getElementById('result').textContent = event.type"></audio>
<pre id="result">waiting</pre>
<script>
  const media = document.getElementById('media');
  media.dispatchEvent(new Event('canplay'));
</script>

Rezultat

canplay

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri