WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

onwheel — der wheel-Ereignishandler

Das globale HTML-Attribut onwheel legt den Code fest, der das wheel-Ereignis behandelt. Es ist kein boolesches Attribut: Sein Wert enthält JavaScript-Anweisungen.

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

Syntax

onwheel="JavaScript statements"
element.onwheel = function (event) { /* ... */ };
element.onwheel = null;

onwheel ist ein globales Ereignisbehandlungsattribut, das für alle HTML-Elemente verfügbar ist. Es gehört zum Ereignis wheel, nicht zu scroll.

Der Attributwert ist der Rumpf einer JavaScript-Funktion, der der Parameter event zur Verfügung steht. Der Eigenschaft element.onwheel wird dagegen eine Funktion zugewiesen; eine weitere Zuweisung ersetzt die vorherige, und null entfernt diesen Handler. Eine Content Security Policy kann Code in Attributen blockieren.

Das Beispiel löst ein synthetisches wheel-Ereignis aus und setzt den Text des Elements auf wheel. Es simuliert weder eine physische Bewegung des Mausrads noch das Scrollen.

Beispiele

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onwheel example</title>
<div id="area" onwheel="this.textContent = event.type">Ready</div>
<script>
  const area = document.getElementById('area');
  area.dispatchEvent(new Event('wheel'));
</script>
</html>

Ergebnis

wheel

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.

Quellen