CKTIS / HTML
ontimeupdate — gérer les mises à jour du temps média
L’attribut ontimeupdate contient du JavaScript qui gère l’événement timeupdate, utilisé lorsque la position de lecture audio ou vidéo est mise à jour. Il permet d’actualiser un indicateur de temps, mais ne fournit pas une mesure précise du temps.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<audio ontimeupdate="JavaScript statements"></audio>
<video ontimeupdate="JavaScript statements"></video>ontimeupdate est un attribut global de gestionnaire d’événement HTML pour timeupdate. Sa valeur est le corps d’une fonction JavaScript, et non une URL ou simplement une déclaration de fonction. Il s’utilise normalement sur les éléments audio et video ; sa présence sur d’autres éléments ne signifie pas que ceux-ci émettent automatiquement cet événement.
Dans le gestionnaire, this désigne l’élément et this.currentTime fournit la position de lecture en secondes. Le navigateur émet timeupdate pendant la lecture et dans d’autres situations où la position change, par exemple lors d’une recherche dans le média. Sa fréquence n’est pas fixe : cet événement n’est ni une horloge ni une notification à chaque image.
L’attribut HTML ontimeupdate contient du texte source, tandis que la propriété JavaScript element.ontimeupdate accepte une fonction ou null. Une autre possibilité est element.addEventListener('timeupdate', handler). La politique de sécurité du contenu (Content Security Policy) peut bloquer le code présent dans les attributs.
L’exemple déclenche volontairement un événement synthétique sans fichier média. Il montre la gestion de l’événement et la lecture de la valeur initiale de currentTime, et non une lecture réelle ou une recherche. Le texte attendu est 0.0 s.
Exemples
<!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>Résultat
0.0 s
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.