KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

onvolumechange — wijzigingen in volume of dempen afhandelen

Het onvolumechange-attribuut bevat JavaScript dat het volumechange-event van een media-element afhandelt. Het reageert op wijzigingen in volume of muted, niet alleen op het verschuiven van een volumeschuifregelaar.

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

Syntax

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

onvolumechange is een globaal HTML-attribuut voor eventafhandeling. De waarde is JavaScript-code die wordt uitgevoerd bij het volumechange-event. Het attribuut kan op elk HTML-element staan, maar de browser verstuurt dit event vanzelf alleen naar media-elementen: audio en video.

Wanneer de DOM-eigenschap volume of muted wordt gewijzigd, komt het event in de wachtrij. De afhandeling gebeurt nadat de bijbehorende setter klaar is, niet synchroon tijdens de toewijzing. Hetzelfde waarde toewijzen zet geen nieuw event in de wachtrij. volume geeft een niveau van 0 tot 1 aan, terwijl muted het dempen onafhankelijk van die waarde regelt.

Verwar het HTML-attribuut met code als waarde niet met de JavaScript-eigenschap onvolumechange, waaraan je een functie toewijst. Een alternatief is addEventListener("volumechange", handler) — de eventnaam heeft geen on-voorvoegsel.

In het voorbeeld schakelt de knop muted om en toont het onvolumechange-attribuut event.type. Een mediabestand of afspelen is niet nodig. JavaScript en eventhandlers die in attributen zijn geschreven, moeten zijn ingeschakeld.

Voorbeelden

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

Resultaat

volumechange

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen