WheelEvent

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

* Some parts of this feature may have varying levels of support.

L'interface WheelEvent représente les évènements qui se produisent lorsque l'utilisateur déplace la molette de la souris ou un périphérique d'entrée similaire.

Attention : Il s'agit de l'interface d'évènement de roue standard à utiliser. Les anciennes versions des navigateurs implémentaient les interfaces MouseWheelEvent et MouseScrollEvent non standard et non compatibles avec plusierus navigateurs. Utilisez cette interface et évitez les non standard.

Note : Ne confondez pas l'évènement wheel avec l'énénement scroll : L'action par défaut d'un évènement wheel est définie par l'implantation. Ainsi, un évènement wheel ne distribue pas nécessairement un évènement scroll. Même lorsque c'est le cas, cela ne signifie pas que les valeurs delta* dans l'évènement wheel reflètent nécessairement la direction de défilement du contenu. Par conséquent, ne comptez pas sur les propriétés delta* pour obtenir la direction de défilement du contenu. Au lieu de cela, détectez les changements de valeurs de scrollLeft et scrollTop de la cible dans l'évènement scroll.

Event UIEvent MouseEvent WheelEvent

Constructeur

WheelEvent()

Crée un objet WheelEvent.

Propriétés

Cette interface hérite des propriétés de ses ancêtres, MouseEvent, UIEvent, et Event.

WheelEvent.deltaXLecture seule

Renvoie un double représentant le montant du défilement horizontal.

WheelEvent.deltaYLecture seule

Renvoie un double représentant le montant du défilement vertical.

WheelEvent.deltaZLecture seule

Renvoie un double représentant le montant du défilement pour l'axe z.

WheelEvent.deltaModeLecture seule

Renvoie un unsigned long représentant l'unité du montant de défilement des valeurs delta*. Les valeurs autorisées sont :

Constant Valeur Description
WheelEvent.DOM_DELTA_PIXEL 0x00 Les valeurs delta* sont spécifiées en pixels.
WheelEvent.DOM_DELTA_LINE 0x01 Les valeurs delta* sont spécifiées en lignes.
WheelEvent.DOM_DELTA_PAGE 0x02 Les valeurs delta* sont spécifiées dans les pages.

Méthodes

Cette interface ne définit aucune méthode spécifique, mais hérite des méthodes de ses ancêtres, MouseEvent, UIEvent, et Event.

Spécifications

Specification
UI Events
# interface-wheelevent

Compatibilité des navigateurs

Voir aussi

  • Évènement wheel

  • Interfaces remplacées par celle-ci :

    • Objet d'évènement de roulette de souris hérité de Gecko: MouseScrollEvent
    • Objet d'évènement de roulette de souris hérité des navigateurs non gecko: MouseWheelEvent