WheelEvent - 表示由于用户移动鼠标滚轮或类似输入设备而发生的事件
WheelEvent
接口表示由于用户移动鼠标滚轮或类似输入设备而发生的事件。
重要提示:这是要使用的标准 wheel 事件的接口。 旧版浏览器实现了非标准且非跨浏览器兼容的
MouseWheelEvent
和MouseScrollEvent
接口。请使用此接口,避免使用非标准接口。
请勿将
wheel
事件与scroll
事件混淆:wheel
事件的默认操作是根据定义实现的。因此,wheel
事件不一定会调度scroll
事件。即使调度了,也并不意味着wheel
事件中的delta*
值一定会反映内容的滚动方向。因此,请勿依赖于delta*
属性来获取内容的滚动方向。应该是在scroll
事件中检测目标的scrollLeft
和scrollTop
的值变化。
构造函数
WheelEvent()
创建一个 WheelEvent
对象。
属性
该接口继承了其祖先 MouseEvent
,UIEvent
和 Event
的属性。
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* 值以页面为单位。 |
方法
该接口未定义任何特定的方法,但继承了其祖先 MouseEvent
,UIEvent
和 Event
的方法。
规范
规范 | 状态 | 备注 |
---|---|---|
UI Events The WheelEvent interface 的定义 |
工作草案 | - |
Document Object Model (DOM) Level 3 Events Specification WheelEvent 的定义 |
已过时 | 初始定义。 |
桌面浏览器兼容性
特性 | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
基础支持 | 31 | 12 | 17 | 9 | 18 | 6.1 |
WheelEvent() 构造函数 | 支持 | ≤18 | 17 | 不支持 | 支持 | 6.1 |
deltaMode | 31 | 12 | 17 | 9 | 18 | 6.1 |
deltaX | 31 | 12 | 17 | 91 | 18 | 6.1 |
deltaY | 31 | 12 | 17 | 91 | 18 | 6.1 |
deltaZ | 31 | 12 | 17 | 91 | 18 | 6.1 |
缩小缩放映射到 WheelEvent + ctrl 键。 | 31 | ≤79 | 55 | 未知 | 未知 | 不支持 |
移动浏览器兼容性
特性 | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
基础支持 | 支持 | 支持 | 未知 | 17 | 未知 | 支持 | 不支持 |
WheelEvent() 构造函数 | 支持 | 支持 | 未知 | 17 | 未知 | 支持 | 不支持 |
deltaMode | 支持 | 支持 | 未知 | 17 | 未知 | 支持 | 不支持 |
deltaX | 支持 | 支持 | 未知 | 17 | 未知 | 支持 | 不支持 |
deltaY | 支持 | 支持 | 未知 | 17 | 未知 | 支持 | 不支持 |
deltaZ | 支持 | 支持 | 未知 | 17 | 未知 | 支持 | 不支持 |
缩小缩放映射到 WheelEvent + ctrl 键。 | 支持 | 支持 | 未知 | 55 | 未知 | 未知 | 不支持 |
1. IE9 支持规范的旧草案,该值是 long
而不是 double
。
相关链接
wheel
事件- 被该接口替换的接口:
- Gecko 的旧鼠标滚轮事件对象:
MouseScrollEvent
- 非 Gecko 浏览器的旧鼠标滚轮事件对象:
MouseWheelEvent
- Gecko 的旧鼠标滚轮事件对象: