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

Element:scrollend 事件

· 52CE 我爱测

`scrollend`** 事件在元素滚动完成时触发。当滚动位置不再有挂起的更新且用户已完成其手势操作时,即视为滚动完成。

CSSOM View API

scrollend 事件在元素滚动完成时触发。当滚动位置不再有挂起的更新且用户已完成其手势操作时,即视为滚动完成。

滚动位置的更新包括平滑或即时的鼠标滚轮滚动、键盘滚动、scroll-snap 事件,或其他会导致滚动位置更新的 API 和手势。触摸平移或触控板滚动等用户手势,在指针或按键释放之前不会被视为完成。如果滚动位置没有发生变化,则不会触发 scrollend 事件。

如需检测 Document 内部的滚动何时完成,请参见 Document 的 Document/scrollend_event 事件。

语法

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

addEventListener("scrollend", (event) => { })

onscrollend = (event) => { }

事件类型

通用的 Event。

示例

在事件监听器中使用 scrollend

下面的示例展示了如何使用 scrollend 事件来检测用户何时停止了滚动:

#scroll-box {
  height: 100px;
  width: 100px;
  float: left;
  overflow: scroll;
  outline: 4px dotted;
  margin: 4px;
}

#scroll-box-title {
  position: fixed;
  top: 5px;
  left: 5px;
  transform: translateX(0);
}

#large-element {
  height: 200px;
  width: 200px;
}

#output {
  text-align: center;
}
<div id="scroll-box">
  <p id="scroll-box-title">滚动我!</p>
  <p id="large-element"></p>
</div>
<p id="output">等待 scroll 事件……</p>
const element = document.querySelector("div#scroll-box");
const output = document.querySelector("p#output");

element.addEventListener("scroll", (event) => {
  output.textContent = "触发 scroll 事件,等待 scrollend……";
});

element.addEventListener("scrollend", (event) => {
  output.textContent = "触发 scrollend 事件!";
});

在事件监听器中使用_scrollend

使用 onscrollend 事件处理器属性

下面的示例展示了如何使用 onscrollend 事件处理器属性来检测用户何时停止了滚动:

#scroll-box {
  height: 100px;
  width: 100px;
  float: left;
  overflow: scroll;
  outline: 4px dotted;
  margin: 4px;
}

#scroll-box-title {
  position: fixed;
  top: 5px;
  left: 5px;
  transform: translateX(0);
}

#large-element {
  height: 200px;
  width: 200px;
}

#output {
  text-align: center;
}
<div id="scroll-box">
  <p id="scroll-box-title">滚动我!</p>
  <p id="large-element"></p>
</div>
<p id="output">等待 scroll 事件……</p>
const element = document.querySelector("div#scroll-box");
const output = document.querySelector("p#output");

element.onscroll = (event) => {
  output.textContent = "元素触发 scroll 事件,等待 scrollend……";
};

element.onscrollend = (event) => {
  output.textContent = "元素触发 scrollend 事件!";
};

使用_onscrollend_事件处理器属性

规范

浏览器兼容性

参见

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

资料来源与适用范围

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

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

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