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

Document:scroll 事件

· 52CE 我爱测

当文档视图滚动后,**`scroll`** 事件就会触发。要检测滚动何时结束,请参阅 Document/scrollend_event。关于元素滚动,请参见 Element/scroll_event。

当文档视图滚动后,scroll 事件就会触发。要检测滚动何时结束,请参阅 Document/scrollend_event。关于元素滚动,请参见 Element/scroll_event。

语法

在类似于 EventTarget.addEventListener 这样的方法中使用事件名称,或设置事件处理器属性。

addEventListener("scroll", (event) => {});

onscroll = (event) => {};

事件类型

通用的 Event。

示例

Scroll 事件限流

由于 scroll 事件可被高频触发,事件处理器不应该执行高性能消耗的操作,如 DOM 操作。而更推荐的做法是使用 Window.requestAnimationFrame()、Window.setTimeout 或 CustomEvent 给事件限流,如下所述。

然而需要注意的是,输入事件和动画帧的触发速度大致相同,因此通常不需要下述优化。此示例使用 requestAnimationFrame 优化 scroll 事件。

let lastKnownScrollPosition = 0;
let ticking = false;

function doSomething(scrollPos) {
  // 利用滚动位置完成一些事情
}

document.addEventListener("scroll", (event) => {
  lastKnownScrollPosition = window.scrollY;

  if (!ticking) {
    window.requestAnimationFrame(() => {
      doSomething(lastKnownScrollPosition);
      ticking = false;
    });

    ticking = true;
  }
});

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

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

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

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