查看原文
其他

Scrollend:超实用的全新JavaScript事件

CUGGZ 前端充电宝 2023-02-07

大家好,我是 CUGGZ。

在开发中,可能会遇到当页面滚动停止之后执行某些操作的需求。在 scrollend 事件之前,并没有可靠的方法来检测页面滚动是否完成。这意味着事件会延迟触发,或者当用户的手指仍在屏幕上时触发。这种不可靠性导致了错误和用户体验不佳。下面就来看看全新的 scrollend 事件是如何使用的!

概述

以前可能会使用定时器来检测滚动停止

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

这个 setTimeout() 可以知道滚动是否停止了 100 毫秒。这使它更像是滚动已暂停事件,而不是滚动已结束事件。

有了 scrollend 事件,浏览器就会帮我们完成滚动停止的监听:

document.onscrollend = event => {…}

可以在 Codepen 查看示例:https://codepen.io/web-dot-dev/pen/rNrJRKg,当滚动停止时会有提示。核心代码如下:

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

使用

scrollend 事件会在以下情况被触发:

  • 用户的触摸已被释放;
  • 用户的指针已释放滚动条;
  • 用户的按键已被释放;
  • 滚动到片段已完成;
  • 滚动捕捉已完成;
  • scrollTo()已完成;
  • 用户已滚动视觉视口。

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

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

这个事件花了很长时间才出现在 Web 平台上的一个原因就是有许多小细节需要进行规范。最复杂的就是视觉视口与文档的滚动结束细节。对于放大的网页,在此缩放状态下,可以四处滚动,但不一定是在滚动文档。不过,即使是这个视觉视口用户驱动的滚动交互也会在完成后发出 scrollend 事件。

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

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

aScrollingElement.addEventListener("scrollend", (event) => {
  // scroll ended
});

也可以使用事件属性:

document.onscrollend = (event) => {
  // scroll ended
};

aScrollingElement.onscrollend = (event) => {
  // scroll ended
};

浏览器支持

目前仅 Firefox 109 版本支持 scrollend 事件。不久的将来,Chrome 111 版本也将支持该事件。

如果现在想要使用这个事件,可以在开始时检查支持情况,如果不支持该事件就继续使用当前的滚动结束策略(如果有的话):

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

这样就能在可用时渐进增强 scrollend 事件。当然也可以使用 polyfill:https://github.com/argyleink/scrollyfills

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

npm i -D scrollyfills

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

import {scrollend} from 'scrollyfills';

someElementThatScrolls.addEventListener('scrollend', event => {
  console.log('scroll has ended');
});

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

参考:https://developer.chrome.com/blog/scrollend-a-new-javascript-event/

往期推荐:

「前端充电宝」2022年精选文章合集!

2023 年 8 大 Web 开发趋势预测!

CSS 原生嵌套语法来了!

Astro 2.0正式发布,现代化静态站点生成器

前端测试技术方案总结

TS、Vue、React、SSR、Node、Deno、Bun:回顾2022,展望2023

2022年CSS都有哪些更新?

您可能也对以下帖子感兴趣

文章有问题?点此查看未经处理的缓存