WheelEvent

WheelEvent 接口表示由于用户移动鼠标滚轮或类似输入设备而发生的事件。

注意：这是要使用的标准滚轮事件接口。旧版本的浏览器实现了非标准且不兼容跨浏览器的 MouseWheelEvent 和 MouseScrollEvent 接口。使用此接口并避免使用非标准接口。

不要将 wheel 事件与 scroll 事件混淆

  • wheel 事件不一定分派 scroll 事件。例如，元素可能根本不可滚动。使用滚轮或触控板进行缩放操作也会触发 wheel 事件。
  • scroll 事件不一定由 wheel 事件触发。也可以使用键盘、拖动滚动条或使用 JavaScript 来滚动元素。
  • 即使 wheel 事件确实触发了滚动，wheel 事件中的 delta* 值也不一定反映内容的滚动方向。
Event UIEvent MouseEvent WheelEvent

构造函数

WheelEvent()

创建一个 WheelEvent 对象。

实例属性

此接口继承自其祖先 MouseEvent、UIEvent 和 Event 的属性。

WheelEvent.deltaX 只读

返回一个 double，表示水平滚动量。

WheelEvent.deltaY 只读

返回一个 double，表示垂直滚动量。

WheelEvent.deltaZ 只读

返回一个 double，表示 z 轴的滚动量。

WheelEvent.deltaMode 只读

返回一个 unsigned long，表示 delta* 值滚动量的单位。允许的值为

常量 值 描述
WheelEvent.DOM_DELTA_PIXEL 0x00 delta* 值以像素为单位。
WheelEvent.DOM_DELTA_LINE 0x01 delta* 值以行为单位。每次鼠标点击都会滚动一行内容，其中计算行高的方法取决于浏览器。
WheelEvent.DOM_DELTA_PAGE 0x02 delta* 值以页为单位。每次鼠标点击都会滚动一页内容。
WheelEvent.wheelDelta 只读

返回一个整数（32 位），表示以像素为单位的距离。

WheelEvent.wheelDeltaX 只读

返回一个整数，表示水平滚动量。

WheelEvent.wheelDeltaY 只读

返回一个整数，表示垂直滚动量。

注意：Element: mousewheel 事件 包含有关已弃用属性 wheelDelta、wheelDeltaX、wheelDeltaY 的其他文档。

实例方法

此接口未定义任何特定方法，但继承自其祖先 MouseEvent、UIEvent 和 Event 的方法。

规范

规范
UI 事件
# interface-wheelevent

浏览器兼容性

BCD 表仅在启用了 JavaScript 的浏览器中加载。

另请参阅