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

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

重要提示:这是要使用的标准 wheel 事件的接口。 旧版浏览器实现了非标准且非跨浏览器兼容的 MouseWheelEventMouseScrollEvent 接口。请使用此接口,避免使用非标准接口。

请勿将 wheel 事件与 scroll 事件混淆:wheel 事件的默认操作是根据定义实现的。因此,wheel 事件不一定会调度 scroll 事件。即使调度了,也并不意味着 wheel 事件中的 delta* 值一定会反映内容的滚动方向。因此,请勿依赖于 delta* 属性来获取内容的滚动方向。应该是在 scroll 事件中检测目标的 scrollLeftscrollTop 的值变化。

构造函数

WheelEvent()

创建一个 WheelEvent 对象。

属性

该接口继承了其祖先 MouseEventUIEventEvent 的属性。

WheelEvent.deltaX 只读

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

WheelEvent.deltaY只读

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

WheelEvent.deltaZ只读

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

WheelEvent.deltaMode只读

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

常量 描述
DOM_DELTA_PIXEL 0x00 delta* 值以像素为单位。
DOM_DELTA_LINE 0x01 delta* 值以行为单位。
DOM_DELTA_PAGE 0x02 delta* 值以页面为单位。

方法

该接口未定义任何特定的方法,但继承了其祖先 MouseEventUIEventEvent 的方法。

规范

规范 状态 备注
UI Events
The WheelEvent interface 的定义
工作草案 -
Document Object Model (DOM) Level 3 Events Specification
WheelEvent 的定义
已过时 初始定义。

桌面浏览器兼容性

特性ChromeEdgeFirefoxInternet ExplorerOperaSafari
基础支持3112179186.1
WheelEvent() 构造函数 支持≤1817 不支持 支持6.1
deltaMode3112179186.1
deltaX31121791186.1
deltaY31121791186.1
deltaZ31121791186.1
缩小缩放映射到 WheelEvent + ctrl 键。31≤7955 未知 未知 不支持

移动浏览器兼容性

特性AndroidChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS Safari
基础支持 支持 支持 未知17 未知 支持 不支持
WheelEvent() 构造函数 支持 支持 未知17 未知 支持 不支持
deltaMode 支持 支持 未知17 未知 支持 不支持
deltaX 支持 支持 未知17 未知 支持 不支持
deltaY 支持 支持 未知17 未知 支持 不支持
deltaZ 支持 支持 未知17 未知 支持 不支持
缩小缩放映射到 WheelEvent + ctrl 键。 支持 支持 未知55 未知 未知 不支持

1. IE9 支持规范的旧草案,该值是 long 而不是 double

相关链接