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 上檢視此頁面 • 報告此內容的錯誤