Window：scrollsnapchanging 事件

可用性有限

此特性不是基线特性，因为它在一些最广泛使用的浏览器中不起作用。

实验性： 这是一项实验性技术
在生产中使用此技术之前，请仔细检查浏览器兼容性表格。

Window 接口的 scrollsnapchanging 事件会在浏览器确定有新的滚动吸附目标（即，在当前滚动手势结束时将被选中的目标）待定（pending）时，在 window 对象上触发。

此事件的运作方式与 Element 接口的 scrollsnapchanging 事件非常相似，只是需要将整个 HTML 文档设置为滚动吸附容器（即，在 <html> 元素上设置了 scroll-snap-type）。

语法

在诸如 addEventListener() 之类的方法中使用事件名称，或设置事件处理程序属性。

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

onscrollsnapchanging = (event) => { }

事件类型

一个 SnapEvent，它继承自通用的 Event 类型。

示例

基本用法

假设我们有一个 <main> 元素，其中包含大量会导致其滚动的内容。

html

<main>
  <!-- Significant content -->
</main>

可以通过组合 CSS 属性将 <main> 元素转变为滚动容器，例如：

css

main {
  width: 250px;
  height: 450px;
  overflow: scroll;
}

然后，我们可以通过在 <html> 元素上指定 scroll-snap-type 属性，来为滚动内容实现滚动吸附行为。

css

html {
  scroll-snap-type: block mandatory;
}

下面的 JavaScript 代码片段会在 <main> 元素的子元素成为待定的吸附目标时，在 HTML 文档上触发 scrollsnapchanging 事件。在处理函数中，我们为由 snapTargetBlock 属性引用的子元素设置一个 pending 类，该类可用于在事件触发时对其进行不同的样式设置。

window.addEventListener("scrollsnapchanging", (event) => {
  // remove previously-set "pending" classes
  const pendingElems = document.querySelectorAll(".pending");
  pendingElems.forEach((elem) => {
    elem.classList.remove("pending");
  });

  // Set current pending snap target class to "pending"
  event.snapTargetBlock.classList.add("pending");
});

在函数开头，我们选择所有先前应用了 pending 类的元素并移除该类，以便只有最新的待定吸附目标会被设置样式。

规范

规范
CSS 滚动捕捉模块级别 2 # scrollsnapchanging

浏览器兼容性

另见

帮助改进 MDN

了解如何贡献

此页面最后修改于 2025年5月2日，由 MDN 贡献者进行编辑。

在 GitHub 上查看此页面 • 报告此内容的错误