CKTIS / HTML
ontimeupdate — gestire gli aggiornamenti del tempo dei media
L’attributo ontimeupdate contiene JavaScript che gestisce l’evento timeupdate, usato quando viene aggiornata la posizione di riproduzione audio o video. Consente di aggiornare un indicatore temporale, ma non offre una misurazione precisa del tempo.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<audio ontimeupdate="JavaScript statements"></audio>
<video ontimeupdate="JavaScript statements"></video>ontimeupdate è un attributo globale HTML per la gestione dell’evento timeupdate. Il suo valore è il corpo di una funzione JavaScript, non un URL né semplicemente una dichiarazione di funzione. Si usa normalmente sugli elementi audio e video; la sua disponibilità su altri elementi non significa che questi generino automaticamente l’evento.
All’interno del gestore, this indica l’elemento e this.currentTime fornisce la posizione di riproduzione in secondi. Il browser genera timeupdate durante la riproduzione e in altre situazioni in cui la posizione cambia, per esempio quando si cerca un punto del contenuto. La frequenza non è fissa: l’evento non è un orologio né una notifica per ogni fotogramma.
L’attributo HTML ontimeupdate contiene testo sorgente, mentre la proprietà JavaScript element.ontimeupdate accetta una funzione oppure null. Un’alternativa è element.addEventListener('timeupdate', handler). La Content Security Policy può bloccare il codice negli attributi.
L’esempio genera intenzionalmente un evento sintetico senza un file multimediale. Mostra come gestire l’evento e leggere il valore iniziale di currentTime, non una riproduzione o una ricerca effettive. Il testo previsto è 0.0 s.
Esempi
<!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>Risultato
0.0 s
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.