CKTIS / HTML
ontimeupdate — obsługa aktualizacji czasu multimediów
Atrybut ontimeupdate zawiera kod JavaScript obsługujący zdarzenie timeupdate, używane przy aktualizacji pozycji odtwarzania audio lub wideo. Pozwala odświeżać wskaźnik czasu, ale nie zapewnia precyzyjnego odmierzania czasu.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
<audio ontimeupdate="JavaScript statements"></audio>
<video ontimeupdate="JavaScript statements"></video>ontimeupdate jest globalnym atrybutem HTML obsługującym zdarzenie timeupdate. Jego wartość to treść funkcji w JavaScript, a nie adres URL ani sama deklaracja funkcji. Zwykle stosuje się go na elementach audio i video; dostępność atrybutu na innych elementach nie oznacza, że automatycznie emitują one to zdarzenie.
W procedurze obsługi this oznacza element, a this.currentTime udostępnia pozycję odtwarzania w sekundach. Przeglądarka emituje timeupdate podczas odtwarzania oraz w innych sytuacjach związanych ze zmianą pozycji, na przykład przy przewijaniu. Częstotliwość nie jest stała: zdarzenie nie jest zegarem ani powiadomieniem o każdej klatce.
Atrybut HTML ontimeupdate zawiera kod tekstowy, natomiast właściwości JavaScript element.ontimeupdate przypisuje się funkcję albo null. Alternatywą jest element.addEventListener('timeupdate', handler). Polityka Content Security Policy może blokować kod w atrybutach.
Przykład celowo wysyła syntetyczne zdarzenie bez pliku multimedialnego. Pokazuje obsługę zdarzenia i odczyt początkowego currentTime, nie rzeczywiste odtwarzanie ani przewijanie. Oczekiwany tekst to 0.0 s.
Przykłady
<!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>Wynik
0.0 s
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.