CKTIS / HTML
onvolumechange — spracovanie zmien hlasitosti alebo stlmenia
Atribút onvolumechange obsahuje JavaScript, ktorý spracúva udalosť volumechange multimediálneho prvku. Reaguje na zmeny vlastností volume alebo muted, nielen na pohyb posúvača hlasitosti.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<audio onvolumechange="handler(event)"></audio>
<video onvolumechange="handler(event)"></video>onvolumechange je globálny atribút HTML na obsluhu udalostí. Jeho hodnotou je kód JavaScriptu, ktorý sa vykoná pri udalosti volumechange. Atribút môže byť uvedený pri ľubovoľnom prvku HTML, ale prehliadač túto udalosť prirodzene odosiela iba multimediálnym prvkom: audio a video.
Zmena vlastnosti DOM volume alebo muted zaradí udalosť do frontu; jej spracovanie nastane po dokončení príslušného setteru, nie synchrónne počas priradenia. Priradenie rovnakej hodnoty nezaradí ďalšiu udalosť. volume určuje úroveň od 0 do 1, zatiaľ čo muted ovláda stlmenie nezávisle od tejto hodnoty.
Nezamieňajte atribút HTML obsahujúci kód s vlastnosťou JavaScriptu onvolumechange, ktorej sa priraďuje funkcia. Alternatívou je addEventListener("volumechange", handler) — názov udalosti nemá predponu on.
V príklade tlačidlo prepína muted a atribút onvolumechange zobrazuje event.type. Nie je potrebný multimediálny súbor ani prehrávanie. JavaScript a obslužné rutiny udalostí zapísané v atribútoch musia byť povolené.
Prí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ýsledok
volumechange
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.