1. Web
  2. Web API
  3. WheelEvent

WheelEvent

Baseline 广泛可用 *

此特性已相当成熟，可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来，各浏览器均已提供此特性。

* 此特性的某些部分可能存在不同级别的支持。

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 只读

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

WheelEvent.deltaMode 只读

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

WheelEvent.wheelDelta 只读

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

WheelEvent.wheelDeltaX 只读

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

WheelEvent.wheelDeltaY 只读

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

注意: Element: mousewheel event 页面包含关于已弃用的属性 wheelDelta、wheelDeltaX、wheelDeltaY 的额外文档。

实例方法

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

规范

规范
UI 事件
# interface-wheelevent

浏览器兼容性

另见

帮助改进 MDN

了解如何贡献

此页面最后修改于 ，由 MDN 贡献者 修改。

在 GitHub 上查看此页面 • 报告此内容的错误
© . Content available under a Creative Commons license.