Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

onvolumechange — gérer les changements de volume ou de sourdine

L’attribut onvolumechange contient du JavaScript qui gère l’événement volumechange d’un élément multimédia. Il réagit aux changements de volume ou de muted, et pas seulement au déplacement d’un curseur de volume.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

<audio onvolumechange="handler(event)"></audio>
<video onvolumechange="handler(event)"></video>

onvolumechange est un attribut HTML global de gestion d’événement. Sa valeur est du code JavaScript exécuté lors de l’événement volumechange. Bien que cet attribut puisse figurer sur n’importe quel élément HTML, le navigateur ne déclenche naturellement cet événement que pour les éléments multimédias : audio et video.

La modification de la propriété DOM volume ou muted met l’événement en file d’attente ; son traitement a lieu une fois le setter correspondant terminé, et non de façon synchrone pendant l’affectation. Attribuer la même valeur ne met pas un nouvel événement en file d’attente. volume définit un niveau de 0 à 1, tandis que muted contrôle la sourdine indépendamment de cette valeur.

Ne confondez pas l’attribut HTML contenant du code avec la propriété JavaScript onvolumechange, à laquelle on affecte une fonction. Une autre possibilité est addEventListener("volumechange", handler) — le nom de l’événement n’a pas de préfixe on.

Dans l’exemple, le bouton bascule muted et l’attribut onvolumechange affiche event.type. Aucun fichier multimédia ni aucune lecture n’est nécessaire. JavaScript et les gestionnaires d’événements écrits dans des attributs doivent être activés.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>onvolumechange</title>
<audio id="media" onvolumechange="document.getElementById('result').textContent = event.type"></audio>
<button type="button" onclick="const media = document.getElementById('media'); media.muted = !media.muted;">Toggle mute</button>
<output id="result" aria-live="polite"></output>

Résultat

volumechange

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.

Sources