--- title: WheelEvent slug: Web/API/WheelEvent tags: - API - DOM - Interface - Reference - WheelEvent translation_of: Web/API/WheelEvent ---
{{APIRef("DOM Events")}}
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 {{DOMxRef("MouseWheelEvent")}} et {{DOMxRef("MouseScrollEvent")}} non standard et non compatibles avec plusierus navigateurs. Utilisez cette interface et évitez les non standard.
Ne confondez pas l'évènement {{domxref("Element/wheel_event", "wheel")}} avec l'énénement {{domxref("Element/scroll_event", "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 {{DOMxRef("Element.scrollLeft", "scrollLeft")}} et {{DOMxRef("Element.scrollTop", "scrollTop")}} de la cible dans l'évènement scroll
.
{{InheritanceDiagram}}
WheelEvent
.Cette interface hérite des propriétés de ses ancêtres, {{DOMxRef("MouseEvent")}}, {{DOMxRef("UIEvent")}}, et {{DOMxRef("Event")}}.
double
représentant le montant du défilement horizontal.double
représentant le montant du défilement vertical.double
représentant le montant du défilement pour l'axe z.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. |
Cette interface ne définit aucune méthode spécifique, mais hérite des méthodes de ses ancêtres, {{DOMxRef("MouseEvent")}}, {{DOMxRef("UIEvent")}}, et {{DOMxRef("Event")}}.
Spécification | Statut | Commentaire |
---|---|---|
{{SpecName("UI Events", "#interface-wheelevent", "The WheelEvent interface")}} |
{{Spec2("UI Events")}} | |
{{SpecName('DOM3 Events', '#interface-wheelevent', 'WheelEvent')}} | {{Spec2('DOM3 Events')}} | Définition initiale. |
{{Compat("api.WheelEvent")}}