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

CKTIS / HTML

onended – obravnava konca predvajanja

Atribut onended vsebuje JavaScript, ki se izvede ob prejemu dogodka ended. Pri elementih audio in video se odzove, ko predstavnostna vsebina doseže konec, ne pa zgolj takrat, ko se predvajanje začasno ustavi.

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

Sintaksa

<audio onended="JavaScript statements"></audio>
<video onended="JavaScript statements"></video>

onended je vsebinski atribut za obravnavo dogodka ended. Njegova vrednost je telo funkcije JavaScript, ne URL datoteke ali zgolj ime funkcije. Za pregled dogodka lahko uporabiš event.

Pri elementih audio in video brskalnik sproži ended, ko predvajanje naprej doseže konec predstavnostne vsebine. Sam klic pause() ne pomeni, da se je predvajanje končalo. Če je nastavljen loop, se predvajanje ob dosegu konca med predvajanjem naprej vrne na začetek, namesto da bi se sprožil ta dogodek.

Razlikuj med atributom HTML onended, lastnostjo JavaScript media.onended, ki vsebuje funkcijo za obravnavo, in logično stanjsko lastnostjo media.ended. Namesto atributa lahko uporabiš media.addEventListener('ended', handler); ime dogodka nima predpone on.

Primer namenoma sproži sintetični dogodek, zato ne potrebuje predstavnostne datoteke. Preveri povezavo obravnavalnika, ne pa dejanskega konca predvajanja. Varnostna politika strani lahko blokira kodo za obravnavo dogodkov, zapisano neposredno v atributu.

Primeri

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

Rezultat

ended

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

Viri