Element: mousewheel event

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.

Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.

Das veraltete und nicht-standardmäßige mousewheel-Ereignis wird asynchron an ein Element ausgelöst, um Aktualisierungen bereitzustellen, während ein Mausrad oder ein ähnliches Gerät betrieben wird. Das mousewheel-Ereignis war nie Teil eines Standards und wurde zwar von mehreren Browsern implementiert, aber nie von Firefox.

Hinweis: Anstelle dieses veralteten Ereignisses sollte das standardmäßige wheel-Ereignis verwendet werden.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignis-Handler-Eigenschaft.

addEventListener("mousewheel", (event) => { })

onmousewheel = (event) => { }

Ereignistyp

Ein WheelEvent. Erbt von MouseEvent, UIEvent und Event.

Ereigniseigenschaften

Diese Schnittstelle erbt Eigenschaften von ihren Vorfahren, MouseEvent, UIEvent und Event.

WheelEvent.deltaX Schreibgeschützt

Gibt ein double zurück, das die horizontale Scrollmenge darstellt.

WheelEvent.deltaY Schreibgeschützt

Gibt ein double zurück, das die vertikale Scrollmenge darstellt.

WheelEvent.deltaZ Schreibgeschützt

Gibt ein double zurück, das die Scrollmenge für die z-Achse darstellt.

WheelEvent.deltaMode Schreibgeschützt

Gibt einen unsigned long zurück, der die Einheit der Scrollmenge der delta*-Werte darstellt. Erlaubte Werte sind:

Konstante	Wert	Beschreibung
`WheelEvent.DOM_DELTA_PIXEL`	`0x00`	Die `delta*`-Werte sind in Pixeln angegeben.
`WheelEvent.DOM_DELTA_LINE`	`0x01`	Die `delta*`-Werte sind in Zeilen angegeben. Jeder Mausklick scrollt eine Zeile des Inhalts, wobei die Methode zur Berechnung der Zeilenhöhe vom Browser abhängt.
`WheelEvent.DOM_DELTA_PAGE`	`0x02`	Die `delta*`-Werte sind in Seiten angegeben. Jeder Mausklick scrollt eine Seite des Inhalts.

WheelEvent.wheelDelta Schreibgeschützt Veraltet

Gibt eine Ganzzahl (32-Bit) zurück, die die Entfernung in Pixeln darstellt.

WheelEvent.wheelDeltaX Schreibgeschützt Veraltet

Gibt eine Ganzzahl zurück, die die horizontale Scrollmenge darstellt.

WheelEvent.wheelDeltaY Schreibgeschützt Veraltet

Gibt eine Ganzzahl zurück, die die vertikale Scrollmenge darstellt.

Die Eigenschaft detail

Der Wert der detail-Eigenschaft ist immer null, außer in Opera, welches detail ähnlich wie das nur in Firefox vorhandene DOMMouseScroll-Ereignis verwendet. Dieses deutet die Scroll-Distanz in Zeilen an, wobei negative Werte anzeigen, dass die Scrollbewegung entweder nach unten oder nach rechts geht, und positive Werte nach oben oder links.

Hinweis: Unter macOS wird die Scrolldistanz (und somit der Wert von detail) basierend auf der beschleunigten Scrolldistanz berechnet.

Unter Linux wird pro nativen Wheel-Event 2 oder -2 gesetzt.

wheelDelta, wheelDeltaX und wheelDeltaY-Wert

Der wheelDelta-Attributwert ist ein abstrakter Wert, der angibt, wie weit das Rad gedreht wurde. Wenn das Rad von der Benutzerin weg gedreht wurde, ist er positiv, andernfalls negativ. Das bedeutet, dass das Vorzeichen des Delta-Werts sich von dem des DOM Level 3 Event's wheel unterscheidet. Jedoch ist die Bedeutung der Menge dieser Werte zwischen den Browsern nicht gleich. Siehe die folgende Erklärung für Details.

IE und Opera (Presto) unterstützen nur das wheelDelta-Attribut und nicht das horizontale Scrollen.

Der wheelDeltaX-Attributwert gibt den wheelDelta-Attributwert entlang der horizontalen Achse an. Wenn ein Benutzer das Gerät zum Scrollen nach rechts betätigt, ist der Wert negativ. Andernfalls, d.h. wenn es nach links geht, ist der Wert positiv.

Der wheelDeltaY-Attributwert gibt den wheelDelta-Attributwert entlang der vertikalen Achse an. Das Vorzeichen des Werts ist dasselbe wie der wheelDelta-Attributwert.

Chrome

Unter Windows ist der Wert derselbe wie der Delta-Wert von WM_MOUSEWHEEL oder WM_MOUSEHWHEEL. Und zudem wird der Wert nicht verändert, selbst wenn die Scrollmenge der Systemeinstellungen auf Seitenscrollen eingestellt ist, d.h. der Wert ist derselbe wie in IE unter Windows.

Unter Linux beträgt der Wert 120 oder -120 pro nativen Wheel-Event. Dies führt zum selben Verhalten wie IE und Chrome für Windows.

Unter Mac ist der Wert kompliziert. Der Wert ändert sich, wenn das Gerät, das das native Wheel-Event verursacht, kontinuierliches Scrollen unterstützt.

Wenn das Gerät kontinuierliches Scrollen unterstützt (z. B. Trackpad eines MacBook oder Mausrad, das sich sanft drehen lässt), wird der Wert anhand der beschleunigten Scrollmenge berechnet. In diesem Fall ist der Wert derselbe wie bei Safari.

Wenn das Gerät kein kontinuierliches Scrollen unterstützt (typischerweise, älteres Mausrad, das sich nicht sanft drehen lässt), wird der Wert anhand der nicht-beschleunigten Scrollmenge (120 pro Kerbe) berechnet. In diesem Fall unterscheidet sich der Wert von Safari.

Dieser Unterschied stellt ein ernstes Problem für Webentwickler dar. Das Problem besteht darin, dass Webentwickler nicht wissen können, ob das mousewheel-Ereignis von welchem Gerät ausgelöst wurde.

Safari

Der Wert wird immer anhand der beschleunigten Scrollmenge berechnet. Das unterscheidet sich wirklich von anderen Browsern, außer Chrome mit einem Gerät, das kontinuierliches Scrollen unterstützt.

Opera (Presto)

Der Wert ist immer der detail-Attributwert ✕ 40.

Unter Windows, da der detail-Attributwert anhand der tatsächlichen Scrollmenge berechnet wird, ist der Wert anders als bei anderen Browsern, außer die Scrollmenge pro Kerbe beträgt 3 Zeilen in den Systemeinstellungen oder eine Seite.

Unter Linux beträgt der Wert 80 oder -80 pro nativen Wheel-Event. Dies unterscheidet sich von anderen Browsern.

Unter Mac wird der detail-Attributwert aus der beschleunigten Scrollmenge des nativen Events berechnet. Der Wert ist in der Regel viel größer als der Wert von Safari oder Chrome.

Das standardmäßige wheel-Ereignis, um stattdessen darauf zu hören.