CKTIS / HTML
ontimeupdate — obravnava posodobitev časa predstavnosti
Atribut ontimeupdate vsebuje JavaScript za obravnavo dogodka timeupdate, ki se uporablja ob posodobitvi položaja predvajanja zvoka ali videa. Omogoča osveževanje prikaza časa, ne zagotavlja pa natančnega merjenja časa.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<audio ontimeupdate="JavaScript statements"></audio>
<video ontimeupdate="JavaScript statements"></video>ontimeupdate je globalni atribut HTML za obravnavo dogodka timeupdate. Njegova vrednost je telo funkcije JavaScript, ne URL ali zgolj deklaracija funkcije. Običajno se uporablja na elementih audio in video; to, da je na voljo tudi pri drugih elementih, ne pomeni, da ti samodejno sprožajo ta dogodek.
V obravnavalniku se this nanaša na element, this.currentTime pa poda položaj predvajanja v sekundah. Brskalnik sproži timeupdate med predvajanjem in v drugih primerih, ko se položaj spremeni, na primer pri iskanju drugega mesta. Pogostost ni določena: dogodek ni ura niti obvestilo za vsako sličico.
Atribut HTML ontimeupdate vsebuje izvorno besedilo, lastnost JavaScript element.ontimeupdate pa sprejme funkcijo ali null. Druga možnost je element.addEventListener('timeupdate', handler). Politika Content Security Policy lahko blokira kodo v atributih.
Primer namenoma sproži sintetični dogodek brez predstavnostne datoteke. Prikazuje obravnavo dogodka in branje začetne vrednosti currentTime, ne pa dejanskega predvajanja ali iskanja. Pričakovano besedilo je 0.0 s.
Primeri
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ontimeupdate demo</title>
<audio id="player" ontimeupdate="document.getElementById('result').textContent = this.currentTime.toFixed(1) + ' s';"></audio>
<output id="result">Waiting</output>
<script>
const player = document.getElementById('player');
player.dispatchEvent(new Event('timeupdate'));
</script>
</html>Rezultat
0.0 s
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.