大家好，我是Echa。

小编记得去年2022年上半年的时候，有不少的前端开发粉丝私信小编问：当页面滚动停止之后执行某个动作，怎么监听？的问题。当时小编就预测chrome 官方大概会在2023年1月实现这个功能，让大家莫着急，看样子还是蛮准的。今天小编给大家详细介绍超实用全新的scrollend 事件如何使用。

scrollend 事件

在实际开发中，大家有没有遇到过关于滚动事件的痛点。我们可以通过 onscroll 事件来监听浏览器是否发生了滚动，但是我们却很难知道滚动会在什么时候完成，这意味着事件会延迟触发，或者当用户的手指仍在屏幕上时触发。这种不可靠性导致了错误和用户体验很不佳。我们以前可能会写出下面的代码：

document.onscroll = event => {  clearTimeout(window.scrollEndTimer)  window.scrollEndTimer = setTimeout(callback, 150)}

我们只能大概预测滚动是在什么时间完成，比如在上面的代码中我们通过 setTimeout 预估滚动可能在 150ms 后完成，这会导致回调函数可能在滚动过程中，或者滚动结束一段时间之后触发，这样的用户体验肯定是不太好的。

有了 scrollend 事件之后，这样的需求就变得简单多了：

document.onscrollend = event => {…}

可以在 Codepen 在线预览：

当滚动停止时会有提示。核心代码如下：

document.onscrollend = event => {  Toast('scroll end')}

如下图：

那么为啥这样一个看起来很简单的事件却花了这么长时间才被 Web 平台支持上呢，其实还是有很多细节需要考虑的。网页视口和滚动的细节其实非常多，假如有一个被放大的网页，你可以在这个状态下进行滚动，但实际上却不一定在滚动文档，即使是这种用户驱动的可视视口滚动交互在完成后也会触发 scrollend 事件。以下是所有 scrollend 事件可能会触发的场景：

浏览器动画结束或滚动完成。用户的触摸被释放。用户的鼠标释放了滚动键。用户的按键被释放。滚动到片段完成。滚动捕捉完成。scrollTo() 完成。用户滚动了可视视口。

scrollend 事件在以下情况下不会触发：

用户的手势没有导致任何滚动位置变化。scrollTo() 没有产生任何位置变化。

与其他滚动事件一样，你可以通过多种方式注册事件侦听器：

addEventListener("scrollend", (event) => {  // 滚动结束});aScrollingElement.addEventListener("scrollend", (event) => {  // 滚动结束});

也可以使用事件属性：

document.onscrollend = (event) => {  // 滚动结束};aScrollingElement.onscrollend = (event) => {  // 滚动结束};

如果你现在想要使用的话，建议先检查事件在当前浏览器版本中是否支持：

'onscrollend' in window// 可用if ('onscrollend' in window) {  document.onscrollend = callback}else {  document.onscroll = event => {    clearTimeout(window.scrollEndTimer)    window.scrollEndTimer = setTimeout(callback, 100)  }}

这个事件目前已经在 Firefox 109 版本中提供支持，后续其他浏览器也将陆续提供支持：

在还没有提供支持的浏览器版本中，你也可以先使用下面这 polyfill：

Github：

首先需要在终端中安装 npm 包

npm i -D scrollyfills

然后在需要的地方使用 scrollend 事件：

import {scrollend} from "scrollyfills"document.onscrollend = callback

polyfill 将渐进增强以使用浏览器内置的 scrollend 事件（如果可用）。如果它不可用，脚本会监视指针事件并滚动以对它可能结束的事件进行最佳评估。

为了保持页面的运行体验流畅，在滚动事件发生时应该尽量避免复杂的计算逻辑。所以很多需要在滚动时触发的复杂的计算我们推荐在 scrollend 事件中完成。一个比较常见的用例是将相关的 UI 元素与滚动停止的位置进行同步。比如下面的场景将轮播滚动位置与点指示器同步。

将滚动轮播图的位置与点指示器进行同步。将图库项目与其元数据进行同步。在用户滚动到新选项卡后获取数据。

你可以在下面这个网站中查看一些真实案例的使用场景和写法：

在线演示：

具体如下：