Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

onvolumechange — obsługa zmiany głośności lub wyciszenia

Atrybut onvolumechange zawiera kod JavaScript obsługujący zdarzenie volumechange elementu multimedialnego. Reaguje na zmianę właściwości volume lub muted, a nie tylko na przesunięcie suwaka głośności.

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

Składnia

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

onvolumechange jest globalnym atrybutem obsługi zdarzeń HTML. Jego wartością jest kod JavaScript wykonywany dla zdarzenia volumechange. Choć atrybut można umieścić na dowolnym elemencie HTML, przeglądarka wysyła to zdarzenie naturalnie tylko do elementów multimedialnych: audio i video.

Zmiana właściwości DOM volume albo muted kolejkuje zdarzenie; obsługa następuje po zakończeniu odpowiedniego settera, nie synchronicznie podczas przypisania. Przypisanie tej samej wartości nie kolejkuje nowego zdarzenia. volume określa poziom od 0 do 1, natomiast muted steruje wyciszeniem niezależnie od tej wartości.

Nie myl atrybutu HTML zawierającego kod z właściwością JavaScript onvolumechange, której przypisuje się funkcję. Alternatywą jest addEventListener("volumechange", handler) — nazwa zdarzenia nie zawiera prefiksu on.

W przykładzie przycisk przełącza muted, a atrybut onvolumechange wyświetla event.type. Nie potrzeba pliku multimedialnego ani odtwarzania. Przykład wymaga włączonego JavaScript i dopuszczenia procedur obsługi zapisanych w atrybutach.

Przykłady

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

Wynik

volumechange

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła