CKTIS / HTML
onratechange — gérer les changements de vitesse de lecture
L’attribut onratechange indique le code JavaScript qui gère l’événement ratechange, déclenché après la modification de playbackRate ou de defaultPlaybackRate d’un élément multimédia.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<audio onratechange="JavaScript statements"></audio>
<video onratechange="JavaScript statements"></video>onratechange est l’attribut de gestion de l’événement ratechange. Il est disponible sur tous les éléments HTML, mais concerne surtout audio et video. Sa valeur est le corps d’une fonction JavaScript, et non un nom d’événement ou une valeur booléenne.
Le navigateur met l’événement en file d’attente lorsque playbackRate ou defaultPlaybackRate change. playbackRate représente la vitesse de lecture effective : 1 correspond à la vitesse normale et 1.5 à une fois et demie cette vitesse. defaultPlaybackRate définit la vitesse par défaut ; le modifier ne change pas à lui seul la vitesse de lecture effective.
Dans le code de l’attribut, this désigne l’élément et event fournit l’événement. La propriété JavaScript correspondante, media.onratechange, accepte une fonction ou null ; affecter une fonction remplace le gestionnaire précédent dans cet emplacement. Une autre possibilité est media.addEventListener('ratechange', handler). CSP peut bloquer le code placé dans les attributs de gestion d’événements.
L’exemple modifie la vitesse sans charger de fichier ni démarrer la lecture. Le résultat apparaît lorsque l’événement mis en file d’attente est traité, et non de façon synchrone pendant l’affectation.
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onratechange demo</title>
<audio id="media" onratechange="document.getElementById('result').textContent = event.type + ': ' + this.playbackRate;"></audio>
<output id="result">Waiting</output>
<script>
document.getElementById('media').playbackRate = 1.5;
</script>
</html>Résultat
ratechange: 1.5
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.