Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

onvolumechange — gestire le modifiche del volume o del silenziamento

L’attributo onvolumechange contiene JavaScript che gestisce l’evento volumechange di un elemento multimediale. Risponde alle modifiche di volume o muted, non solo allo spostamento di un cursore del volume.

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

Sintassi

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

onvolumechange è un attributo globale HTML per la gestione degli eventi. Il suo valore è codice JavaScript eseguito per l’evento volumechange. Anche se l’attributo può comparire su qualsiasi elemento HTML, il browser invia naturalmente questo evento solo agli elementi multimediali: audio e video.

La modifica della proprietà DOM volume o muted accoda l’evento; la gestione avviene dopo che il setter corrispondente è terminato, non in modo sincrono durante l’assegnazione. Assegnare lo stesso valore non accoda un altro evento. volume specifica un livello da 0 a 1, mentre muted controlla il silenziamento indipendentemente da quel valore.

Non confondere l’attributo HTML che contiene codice con la proprietà JavaScript onvolumechange, a cui si assegna una funzione. Un’alternativa è addEventListener("volumechange", handler) — il nome dell’evento non ha il prefisso on.

Nell’esempio, il pulsante attiva o disattiva muted e l’attributo onvolumechange mostra event.type. Non servono file multimediali né la riproduzione. JavaScript e i gestori di eventi scritti negli attributi devono essere abilitati.

Esempi

<!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>

Risultato

volumechange

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti