CKTIS / HTML
ontimeupdate — Aktualisierungen der Medienzeit behandeln
Das Attribut ontimeupdate enthält JavaScript zur Behandlung des Ereignisses timeupdate, das bei Änderungen der Audio- oder Videowiedergabeposition verwendet wird. Damit lässt sich eine Zeitanzeige aktualisieren, eine präzise Zeitmessung bietet es jedoch nicht.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<audio ontimeupdate="JavaScript statements"></audio>
<video ontimeupdate="JavaScript statements"></video>ontimeupdate ist ein globales HTML-Ereignisbehandlungsattribut für timeupdate. Sein Wert ist der JavaScript-Code einer Funktionsroutine, keine URL und nicht bloß eine Funktionsdeklaration. Es wird normalerweise auf audio- und video-Elementen verwendet; dass das Attribut auch auf anderen Elementen verfügbar ist, bedeutet nicht, dass diese das Ereignis automatisch auslösen.
Innerhalb der Routine verweist this auf das Element, und this.currentTime liefert die Wiedergabeposition in Sekunden. Der Browser löst timeupdate während der Wiedergabe und auch in anderen Situationen aus, in denen sich die Position ändert, etwa beim Suchen. Die Häufigkeit ist nicht festgelegt: Das Ereignis ist weder eine Uhr noch eine Benachrichtigung für jedes einzelne Bild.
Das HTML-Attribut ontimeupdate enthält Quelltext, während die JavaScript-Eigenschaft element.ontimeupdate eine Funktion oder null annimmt. Eine Alternative ist element.addEventListener('timeupdate', handler). Die Content Security Policy kann Code in Attributen blockieren.
Das Beispiel löst absichtlich ein synthetisches Ereignis aus, ohne eine Mediendatei zu verwenden. Es zeigt die Behandlung des Ereignisses und das Auslesen des anfänglichen Werts von currentTime, nicht die tatsächliche Wiedergabe oder das Suchen. Der erwartete Text lautet 0.0 s.
Beispiele
<!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>Ergebnis
0.0 s
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.