CKTIS / HTML
onvolumechange — Änderungen der Lautstärke oder Stummschaltung behandeln
Das Attribut onvolumechange enthält JavaScript-Code zur Behandlung des volumechange-Ereignisses eines Medienelements. Es reagiert auf Änderungen an volume oder muted, nicht nur auf das Bewegen eines Lautstärkereglers.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<audio onvolumechange="handler(event)"></audio>
<video onvolumechange="handler(event)"></video>onvolumechange ist ein globales HTML-Attribut für Ereignisbehandlungen. Sein Wert ist JavaScript-Code, der beim Ereignis volumechange ausgeführt wird. Das Attribut kann zwar auf jedem HTML-Element stehen, der Browser löst dieses Ereignis jedoch von sich aus nur für Medienelemente aus: audio und video.
Eine Änderung der DOM-Eigenschaft volume oder muted reiht das Ereignis in die Warteschlange ein. Die Behandlung erfolgt nach Abschluss des zugehörigen Setters, nicht synchron während der Zuweisung. Wird derselbe Wert zugewiesen, wird kein weiteres Ereignis eingereiht. volume legt einen Wert von 0 bis 1 fest, während muted die Stummschaltung unabhängig davon steuert.
Verwechsle nicht das HTML-Attribut mit JavaScript-Code als Wert mit der JavaScript-Eigenschaft onvolumechange, der eine Funktion zugewiesen wird. Eine Alternative ist addEventListener("volumechange", handler) — der Ereignisname hat kein on-Präfix.
Im Beispiel schaltet die Schaltfläche muted um, und das Attribut onvolumechange zeigt event.type an. Eine Mediendatei oder Wiedergabe ist nicht erforderlich. JavaScript und in Attributen notierte Ereignisbehandlungen müssen aktiviert sein.
Beispiele
<!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>Ergebnis
volumechange
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.