Element: DOMMouseScroll-Ereignis

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, kann sie bereits aus den relevanten Webstandards entfernt worden sein, befindet sich im Prozess der Entfernung oder wird nur aus Kompatibilitätsgründen beibehalten. Vermeiden Sie die Verwendung und aktualisieren Sie gegebenenfalls bestehenden Code; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu treffen. Beachten Sie, dass diese Funktion jederzeit nicht mehr funktionieren kann.

Kein Standard: Diese Funktion ist nicht standardisiert und befindet sich nicht im Standardisierungsprozess. Verwenden Sie sie nicht auf Produktionsseiten, die auf das Web ausgerichtet sind: Sie wird nicht für alle Benutzer funktionieren. Außerdem kann es große Inkompatibilitäten zwischen Implementierungen geben und das Verhalten kann sich in Zukunft ändern.

Das DOM-DOMMouseScroll-Ereignis wird asynchron ausgelöst, wenn das Mausrad oder ein ähnliches Gerät betätigt wird und die akkumulierte Scrollmenge seit dem letzten Ereignis über 1 Linie oder 1 Seite beträgt. Es wird durch die MouseScrollEvent-Schnittstelle dargestellt. Dieses Ereignis wurde nur von Firefox implementiert. Stattdessen sollten Sie das standardisierte wheel-Ereignis verwenden.

Wenn Sie die Standardaktion von Mausrad-Ereignissen verhindern möchten, reicht es nicht aus, nur dieses Ereignis in Gecko zu behandeln, da, wenn die Scrollmenge eines nativen Mausrad-Ereignisses weniger als 1 Linie (oder weniger als 1 Seite, wenn die Systemeinstellung nach Seiten scrollen ist) beträgt, andere Mausrad-Ereignisse ohne dieses Ereignis ausgelöst werden können.

Ab Gecko 17 (Firefox 17) oder später müssen Sie preventDefault() für wheel-Ereignisse aufrufen, die für jedes native Ereignis ausgelöst werden müssen.

Verwenden Sie das standardisierte wheel-Ereignis, wenn verfügbar.

Syntax

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

js
addEventListener("DOMMouseScroll", (event) => {});

onDOMMouseScroll = (event) => {};

Ereignistyp

Ereigniseigenschaften

Das Ereignis hat nur eine zusätzliche Eigenschaft über die Standardereignisse hinaus.

detail

Die detail-Eigenschaft beschreibt das Scrollen genauer, wobei positive Werte nach unten scrollen und negative Werte nach oben scrollen anzeigen.

Wenn das Ereignis das Scrollen um eine Seite nach oben darstellt, hat die detail-Eigenschaft den Wert -32768. Wenn das Ereignis das Scrollen um eine Seite nach unten anzeigt, hat die detail-Eigenschaft den Wert +32768. Jeder andere Wert stellt die Anzahl der zu scrollenden Linien dar, wobei die Richtung durch das Vorzeichen des Wertes angezeigt wird.

Hinweis: Vertrauenswürdige Ereignisse werden niemals mit einem Wert von 0 für detail gesendet.

Vertrauenswürdige Ereignisse werden niemals mit 0 ausgelöst.

Hinweis: Wenn die nativen Mausrad-Ereignisse der Plattform nur Scrollabstand in Pixel bereitstellen oder wenn die Geschwindigkeit vom Benutzer angepasst werden kann, wird der Wert mithilfe der Zeilenhöhe des nächstgelegenen scrollbaren Vorgängerelements des Ereignisziels berechnet. Wenn die Schriftgröße dieses Elements kleiner als mousewheel.min_line_scroll_amount ist, wird der Wert dieser Präferenz als Zeilenhöhe verwendet.

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

  • MouseScrollEvent
  • Geckos veraltetes Pixel-Scroll-Ereignis: MozMousePixelScroll
  • Veraltetes Mausrad-Ereignis von Nicht-Gecko-Browsern: mousewheel
  • Standardisiertes Wheel-Ereignis: wheel