CKTIS / HTML
onvolumechange — tratar alterações do volume ou do modo sem som
O atributo onvolumechange contém JavaScript que trata o evento volumechange de um elemento multimédia. Responde a alterações em volume ou muted, e não apenas ao movimento de um cursor de volume.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<audio onvolumechange="handler(event)"></audio>
<video onvolumechange="handler(event)"></video>onvolumechange é um atributo global de HTML para tratamento de eventos. O seu valor é código JavaScript executado para o evento volumechange. Embora o atributo possa surgir em qualquer elemento HTML, o navegador só envia naturalmente este evento para elementos multimédia: audio e video.
A alteração da propriedade DOM volume ou muted coloca o evento na fila; o tratamento ocorre depois de terminar o setter correspondente, não de forma síncrona durante a atribuição. Atribuir o mesmo valor não coloca outro evento na fila. volume especifica um nível de 0 a 1, enquanto muted controla o modo sem som independentemente desse valor.
Não confundas o atributo HTML que contém código com a propriedade JavaScript onvolumechange, à qual se atribui uma função. Uma alternativa é addEventListener("volumechange", handler) — o nome do evento não tem o prefixo on.
No exemplo, o botão alterna muted e o atributo onvolumechange apresenta event.type. Não é necessário um ficheiro multimédia nem a reprodução de conteúdo. É necessário ter o JavaScript e os tratadores de eventos escritos em atributos ativados.
Exemplos
<!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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.