文件：scrollsnapchanging 事件

可用性有限

此特性不是基線特性，因為它在一些最廣泛使用的瀏覽器中不起作用。

實驗性： 這是一項實驗性技術
在生產中使用此技術之前，請仔細檢查瀏覽器相容性表格。

當瀏覽器確定新的滾動捕捉目標（即，將在當前滾動操作結束時被選中）待定（pending）時，在 Document 介面的滾動容器上觸發 scrollsnapchanging 事件。

此事件的工作方式與 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 類，該類可在事件觸發時用於對其進行不同的樣式設定。

document.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 上檢視此頁面 • 報告此內容的潛在問題