大网数据广告活动
Web 标准与前端开发

WheelEvent

· 52CE 我爱测

`WheelEvent`** 接口表示用户滚动鼠标滚轮或类似的输入设备时触发的事件。

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_PIXEL 0x00 delta* 的单位为像素。
      WheelEvent.DOM_DELTA_LINE 0x01 delta* 单位为行。每一次点击鼠标都会滚动一行内容,行高的计算取决于浏览器。
      WheelEvent.DOM_DELTA_PAGE 0x02 delta* 单位为页。每一次点击鼠标都会滚动一页内容。
  • 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。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。