CKTIS / HTML
ontimeupdate — wijzigingen in de mediatijd afhandelen
Het attribuut ontimeupdate bevat JavaScript dat de gebeurtenis timeupdate afhandelt, die wordt gebruikt wanneer de afspeelpositie van audio of video wordt bijgewerkt. Het kan een tijdsaanduiding vernieuwen, maar biedt geen nauwkeurige tijdmeting.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<audio ontimeupdate="JavaScript statements"></audio>
<video ontimeupdate="JavaScript statements"></video>ontimeupdate is een globaal HTML-attribuut voor de gebeurtenisafhandeling van timeupdate. De waarde is de inhoud van een JavaScript-functie, geen URL en niet alleen een functiedeclaratie. Het wordt meestal gebruikt op audio- en video-elementen; dat het ook op andere elementen beschikbaar is, betekent niet dat deze de gebeurtenis automatisch uitzenden.
Binnen de handler verwijst this naar het element en geeft this.currentTime de afspeelpositie in seconden. De browser zendt timeupdate uit tijdens het afspelen en in andere situaties waarin de positie verandert, bijvoorbeeld bij het zoeken. De frequentie ligt niet vast: de gebeurtenis is geen klok en ook geen melding voor elk frame.
Het HTML-attribuut ontimeupdate bevat broncode als tekst, terwijl de JavaScript-eigenschap element.ontimeupdate een functie of null accepteert. Een alternatief is element.addEventListener('timeupdate', handler). Het Content Security Policy-beleid kan code in attributen blokkeren.
Het voorbeeld verstuurt bewust een synthetische gebeurtenis zonder mediabestand. Het laat zien hoe je de gebeurtenis afhandelt en de beginwaarde van currentTime uitleest, niet hoe je daadwerkelijk afspeelt of zoekt. De verwachte tekst is 0.0 s.
Voorbeelden
<!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>Resultaat
0.0 s
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.