Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes