WheelEvent

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.

Important: 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.

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.

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
Revnoie 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

Spécification Statut Commentaire
UI Events
La définition de 'The WheelEvent interface' dans cette spécification.
Version de travail
Document Object Model (DOM) Level 3 Events Specification
La définition de 'WheelEvent' dans cette spécification.
Obsolete Définition initiale.

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung Internet
WheelEventChrome Support complet 31Edge Support complet 12Firefox Support complet 17IE Support complet 9Opera Support complet 18Safari Support complet 6.1WebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 17Opera Android Support complet OuiSafari iOS Aucun support NonSamsung Internet Android Support complet Oui
WheelEvent() constructorChrome Support complet OuiEdge Support complet ≤18Firefox Support complet 17IE Aucun support NonOpera Support complet OuiSafari Support complet 6.1WebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 17Opera Android Support complet OuiSafari iOS Aucun support NonSamsung Internet Android Support complet Oui
deltaModeChrome Support complet 31Edge Support complet 12Firefox Support complet 17IE Support complet 9Opera Support complet 18Safari Support complet 6.1WebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 17Opera Android Support complet OuiSafari iOS Aucun support NonSamsung Internet Android Support complet Oui
deltaXChrome Support complet 31Edge Support complet 12Firefox Support complet 17IE Support complet 9
Notes
Support complet 9
Notes
Notes IE9 supports an old draft of the spec where this value was a long instead of a double.
Opera Support complet 18Safari Support complet 6.1WebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 17Opera Android Support complet OuiSafari iOS Aucun support NonSamsung Internet Android Support complet Oui
deltaYChrome Support complet 31Edge Support complet 12Firefox Support complet 17IE Support complet 9
Notes
Support complet 9
Notes
Notes IE9 supports an old draft of the spec where this value was a long instead of a double.
Opera Support complet 18Safari Support complet 6.1WebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 17Opera Android Support complet OuiSafari iOS Aucun support NonSamsung Internet Android Support complet Oui
deltaZChrome Support complet 31Edge Support complet 12Firefox Support complet 17IE Support complet 9
Notes
Support complet 9
Notes
Notes IE9 supports an old draft of the spec where this value was a long instead of a double.
Opera Support complet 18Safari Support complet 6.1WebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 17Opera Android Support complet OuiSafari iOS Aucun support NonSamsung Internet Android Support complet Oui
Pinch-to-zoom maps to WheelEvent + ctrl key.Chrome Support complet 31Edge Support complet ≤79Firefox Support complet 55IE ? Opera ? Safari Aucun support NonWebView Android Support complet OuiChrome Android Support complet OuiFirefox Android Support complet 55Opera Android ? Safari iOS Aucun support NonSamsung Internet Android Support complet Oui

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Compatibilité inconnue  
Compatibilité inconnue
Voir les notes d'implémentation.
Voir les notes d'implémentation.

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