UI Events
WheelEvent 接口表示用户滚动鼠标滚轮或类似的输入设备时触发的事件。
[!NOTE] 该事件为标准规定的滚轮事件接口。早期的浏览器实现过
MouseWheelEvent和 MouseScrollEvent 两种滚轮事件接口,但这两种接口皆非标准,加之各浏览器间对其兼容性极差。因而开发者应使用该标准事件接口取代这两个非标准接口。
[!NOTE] 不要混淆 Element/wheel_event 事件和 Element/scroll_event 事件。
wheel事件的默认动作取决于浏览器实现。因此wheel事件不一定会触发scroll事件。即便wheel事件引发了文档内容的滚动行为,也不表示wheel事件中的delta*值恰好反映文档内容的滚动方向。因此,不要依赖delta*属性获知文档内容的滚动方向。而应该在scroll事件中监听目标的 Element.scrollLeft 和 Element.scrollTop 的变化以推断滚动方向。
构造函数
- WheelEvent.WheelEvent
- : 创建一个
WheelEvent对象。
- : 创建一个
属性
该接口继承了父接口 MouseEvent、UIEvent 和 Event 的属性。
-
WheelEvent.deltaX
- : 返回一个
double值,该值表示滚轮的横向滚动量。
- : 返回一个
-
WheelEvent.deltaY
- : 返回一个
double值,该值表示滚轮的纵向滚动量。
- : 返回一个
-
WheelEvent.deltaZ
- : 返回一个
double值,该值表示滚轮的 z 轴方向上的滚动量。
- : 返回一个
-
WheelEvent.deltaMode
-
: 返回一个
unsigned long值,该值表示上述各delta*的值的单位。允许的值如下:常量 值 描述 WheelEvent.DOM_DELTA_PIXEL0x00delta*的单位为像素。WheelEvent.DOM_DELTA_LINE0x01delta*单位为行。每一次点击鼠标都会滚动一行内容,行高的计算取决于浏览器。WheelEvent.DOM_DELTA_PAGE0x02delta*单位为页。每一次点击鼠标都会滚动一页内容。
-
-
WheelEvent.wheelDelta
- : 返回一个整数(32 位),表示以像素为单位的距离。
-
WheelEvent.wheelDeltaX
- : 返回一个整数,表示水平滚动量。
-
WheelEvent.wheelDeltaY
- : 返回一个整数,表示垂直滚动量。
[!NOTE] 元素:mousewheel 事件有关于已弃用的属性(
wheelDelta、wheelDeltaX和wheelDeltaY)的额外说明。
方法
该接口本身未定义方法,但继承了父接口 MouseEvent、UIEvent、Event 的方法。
规范
浏览器兼容性
参见
- Element/wheel_event 事件
- 该接口取代的过时接口:
- MouseScrollEvent(Gecko 内核浏览器)
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
