CKTIS / HTML
onvolumechange — zpracování změn hlasitosti nebo ztlumení
Atribut onvolumechange obsahuje JavaScript, který zpracovává událost volumechange multimediálního prvku. Reaguje na změny vlastností volume nebo muted, nejen na pohyb posuvníku hlasitosti.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<audio onvolumechange="handler(event)"></audio>
<video onvolumechange="handler(event)"></video>onvolumechange je globální atribut HTML pro obsluhu událostí. Jeho hodnotou je kód JavaScriptu, který se vykoná při události volumechange. Atribut může být uveden u libovolného prvku HTML, ale prohlížeč tuto událost přirozeně odesílá pouze multimediálním prvkům: audio a video.
Změna vlastnosti DOM volume nebo muted zařadí událost do fronty; její zpracování proběhne až po dokončení příslušného setteru, nikoli synchronně během přiřazení. Přiřazení stejné hodnoty nezařadí další událost. volume určuje úroveň od 0 do 1, zatímco muted ovládá ztlumení nezávisle na této hodnotě.
Nezaměňujte atribut HTML obsahující kód s vlastností JavaScriptu onvolumechange, které se přiřazuje funkce. Alternativou je addEventListener("volumechange", handler) — název události nemá předponu on.
V příkladu tlačítko přepíná muted a atribut onvolumechange zobrazuje event.type. Není potřeba žádný multimediální soubor ani přehrávání. JavaScript a obslužné rutiny událostí zapsané v atributech musí být povolené.
Příklady
<!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>Výsledek
volumechange
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.