一个全新的 JavaScript 事件!
大家好,我是 ConardLi。先祝大家开工大吉!
今天给大家介绍一个新的 JavaScript 事件:scrollend
。
不知道大家在网页开发的过程中有没有遇到过关于滚动事件的痛点,我们可以通过 onscroll
事件来监听浏览器是否发生了滚动,但是我们却很难知道滚动会在什么时候完成,我们可能会写出下面的代码:
document.onscroll = event => {
clearTimeout(window.scrollEndTimer)
window.scrollEndTimer = setTimeout(callback, 100)
}
我们只能大概预测滚动是在什么事件完成,比如在上面的代码中我们通过 setTimeout
预估滚动可能在 100ms
后完成,这会导致回调函数可能在滚动过程中,或者滚动结束一段事件之后触发,这样的用户体验肯定是不太好的。
有了 scrollend
事件之后,这样的需求就变得简单多了:
document.onscrollend = event => {…}
那么为啥这样一个看起来很简单的事件却花了这么长时间才被 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
:
https://github.com/argyleink/scrollyfills
import {scrollend} from "scrollyfills"
document.onscrollend = callback
为了保持页面的运行体验流畅,在滚动事件发生时应该尽量避免复杂的计算逻辑。所以很多需要在滚动时触发的复杂的计算我们推荐在 scrollend
事件中完成。一个比较常见的用例是将相关的 UI 元素与滚动停止的位置进行同步。比如下面的场景将轮播滚动位置与点指示器同步。
将滚动轮播图的位置与点指示器进行同步。 将图库项目与其元数据进行同步。 在用户滚动到新选项卡后获取数据。
你可以在下面这个网站中查看一些真实案例的使用场景和写法:
https://gui-challenges.web.app/carousel/dist/
最后
参考链接
https://github.com/argyleink/scrollyfills https://developer.chrome.com/en/blog/scrollend-a-new-javascript-event/
如果这篇文章帮助到了你,欢迎点赞和关注。
如果你想加入高质量前端交流群,或者你有任何其他事情想和我交流也可以添加我的个人微信 ConardLi 。
点赞
和在看
是最大的支持⬇️❤️⬇️