CKTIS / HTML
ondurationchange — gérer les changements de durée des médias
L’attribut ondurationchange contient du JavaScript exécuté lors de l’événement durationchange. Il sert généralement à mettre à jour les informations de durée des éléments audio et video ; il ne signale pas la progression de la lecture en cours.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
ondurationchange="JavaScript statements"ondurationchange est un attribut de gestionnaire d’événement associé à durationchange, généralement utilisé avec les éléments audio et video. Sa valeur est du code JavaScript, et non un booléen ni une valeur de durée. Dans le gestionnaire défini par l’attribut, this désigne l’élément et event fournit l’objet événement.
Le navigateur déclenche cet événement lorsque la durée établie de la ressource change, par exemple lorsqu’elle devient connue ou qu’elle est révisée. Consultez this.duration : le résultat est exprimé en secondes, NaN signifie qu’aucune donnée n’est disponible et Infinity indique une durée non bornée. Il ne s’agit pas d’un événement de progression de la lecture ; utilisez timeupdate à cette fin.
En JavaScript, vous pouvez plutôt affecter une fonction à media.ondurationchange ou utiliser media.addEventListener('durationchange', handler). Le nom de l’événement ne comporte pas de préfixe on. L’affectation à la propriété remplace le gestionnaire déjà présent dans cet emplacement ; addEventListener permet d’ajouter des écouteurs indépendants. Une politique CSP peut bloquer le code écrit directement dans l’attribut.
L’exemple déclenche un événement synthétique sans récupérer de média. Il vérifie le lien entre l’attribut et le gestionnaire, et non la détection d’un véritable changement de durée. Il ne modifie pas duration ; le texte attendu est donc durationchange: NaN.
Exemples
<!doctype html>
<meta charset="utf-8">
<title>ondurationchange</title>
<audio id="media" ondurationchange="document.getElementById('result').textContent = event.type + ': ' + String(this.duration)"></audio>
<output id="result"></output>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('durationchange'));
</script>Résultat
durationchange: NaN
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.