WheelEvent

Die WheelEvent-Schnittstelle repräsentiert Ereignisse, die auftreten, wenn der Benutzer ein Mausrad oder ein ähnliches Eingabegerät bewegt.

Hinweis: Dies ist die standardisierte Wheel-Event-Schnittstelle, die verwendet werden sollte. Ältere Versionen von Browsern implementierten die nicht standardisierten und nicht browserübergreifend kompatiblen MouseWheelEvent und MouseScrollEvent-Schnittstellen. Diese Schnittstelle verwenden und die nicht standardisierten vermeiden.

Verwechseln Sie das wheel-Ereignis nicht mit dem scroll-Ereignis:

  • Ein wheel-Ereignis löst nicht unbedingt ein scroll-Ereignis aus. Zum Beispiel kann das Element überhaupt nicht scrollbar sein. Zoom-Aktionen mit dem Rad oder Trackpad lösen ebenfalls wheel-Ereignisse aus.
  • Ein scroll-Ereignis wird nicht unbedingt durch ein wheel-Ereignis ausgelöst. Elemente können auch durch Verwendung der Tastatur, Ziehen eines Scrollbalkens oder durch JavaScript gescrollt werden.
  • Selbst wenn das wheel-Ereignis Scrollen auslöst, spiegeln die delta*-Werte im wheel-Ereignis nicht unbedingt die Scrollrichtung des Inhalts wider.
Event UIEvent MouseEvent WheelEvent

Konstruktor

WheelEvent()

Erstellt ein WheelEvent-Objekt.

Instanz-Eigenschaften

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

WheelEvent.deltaX Schreibgeschützt

Gibt ein double zurück, das die horizontale Scroll-Menge darstellt.

WheelEvent.deltaY Schreibgeschützt

Gibt ein double zurück, das die vertikale Scroll-Menge darstellt.

WheelEvent.deltaZ Schreibgeschützt

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

WheelEvent.deltaMode Schreibgeschützt

Gibt ein unsigned long zurück, der die Einheit der Scroll-Menge der delta*-Werte repräsentiert. 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 Inhalt, wobei die Methode zur Berechnung der Zeilenhöhe vom Browser abhängig ist.
WheelEvent.DOM_DELTA_PAGE 0x02 Die delta*-Werte sind in Seiten angegeben. Jeder Mausklick scrollt eine Seite Inhalt.
WheelEvent.wheelDelta Schreibgeschützt

Gibt einen Integer (32-Bit) zurück, der die Entfernung in Pixeln darstellt.

WheelEvent.wheelDeltaX Schreibgeschützt

Gibt einen Integer zurück, der die horizontale Scroll-Menge darstellt.

WheelEvent.wheelDeltaY Schreibgeschützt

Gibt einen Integer zurück, der die vertikale Scroll-Menge darstellt.

Hinweis: Element: mousewheel event enthält zusätzliche Dokumentation zu den veralteten Eigenschaften wheelDelta, wheelDeltaX, wheelDeltaY.

Instanz-Methoden

Diese Schnittstelle definiert keine spezifischen Methoden, erbt jedoch Methoden von ihren Vorfahren, MouseEvent, UIEvent und Event.

Spezifikationen

Specification
UI Events
# interface-wheelevent

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

  • wheel-Ereignis

  • Von diesem abgelöste Schnittstellen: