WheelEvent: WheelEvent() constructor

The WheelEvent() constructor returns a new WheelEvent object.

Note: If you construct a synthetic event using this constructor, that event will not be trusted, for security reasons. Only browser-generated WheelEvent objects are trusted and only trusted events trigger default actions.

Syntax

js
new WheelEvent(type)
new WheelEvent(type, options)

Parameters

type

A string with the name of the event. It is case-sensitive and browsers always set it to wheel.

options Optional

An object that, in addition of the properties defined in MouseEvent(), can have the following properties:

deltaX Optional

A floating number representing the horizontal scroll amount in the deltaMode unit. It defaults to 0.0.

deltaY Optional

A floating number representing the vertical scroll amount in the deltaMode unit. It defaults to 0.0.

deltaZ Optional

A floating number representing the scroll amount for the z-axis scroll amount in the deltaMode unit. It defaults to 0.0.

deltaMode Optional

An integer representing the unit of the delta values scroll amount. It defaults to 0x00. Permitted values are:

ConstantValueDescription
DOM_DELTA_PIXEL0x00The delta values are specified in pixels.
DOM_DELTA_LINE0x01The delta values are specified in lines.
DOM_DELTA_PAGE0x02The delta values are specified in pages.

Return value

A new WheelEvent object.

Specifications

See also