CKTIS / HTML
onvolumechange — gestionar cambios de volumen o silencio
El atributo onvolumechange contiene JavaScript que gestiona el evento volumechange de un elemento multimedia. Responde a cambios en volume o muted, no solo al movimiento de un control deslizante de volumen.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
<audio onvolumechange="handler(event)"></audio>
<video onvolumechange="handler(event)"></video>onvolumechange es un atributo global de HTML para gestionar eventos. Su valor es código JavaScript que se ejecuta cuando se produce el evento volumechange. Aunque el atributo puede aparecer en cualquier elemento HTML, el navegador solo envía este evento de forma natural a los elementos multimedia: audio y video.
Cambiar la propiedad DOM volume o muted pone el evento en cola; se gestiona después de que termine el setter correspondiente, no de forma síncrona durante la asignación. Asignar el mismo valor no pone otro evento en cola. volume establece un nivel de 0 a 1, mientras que muted controla el silencio independientemente de ese valor.
No confundas el atributo HTML que contiene código con la propiedad JavaScript onvolumechange, a la que se asigna una función. Otra opción es addEventListener("volumechange", handler) — el nombre del evento no lleva el prefijo on.
En el ejemplo, el botón alterna muted y el atributo onvolumechange muestra event.type. No hace falta ningún archivo multimedia ni reproducir contenido. Es necesario tener JavaScript y habilitados los controladores de eventos escritos en atributos.
Ejemplos
<!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>Resultado
volumechange
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.