Dokument: scrollsnapchanging Ereignis

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Das scrollsnapchanging Ereignis des Document-Interfaces wird im Scroll-Container ausgelöst, wenn der Browser bestimmt, dass ein neues Scroll-Snap-Ziel ansteht, d.h. es wird ausgewählt, wenn die aktuelle Scroll-Geste endet.

Dieses Ereignis funktioniert ähnlich wie das Element-Interface-Ereignis scrollsnapchanging, außer dass das gesamte HTML-Dokument als der Scroll-Snap-Container gesetzt werden muss (d.h. scroll-snap-type ist auf das <html>-Element gesetzt).

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignis-Handler-Eigenschaft.

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

onscrollsnapchanging = (event) => {};

Ereignistyp

Ein SnapEvent, das vom generischen Event-Typ erbt.

Beispiele

Grundlegende Nutzung

Angenommen, wir haben ein <main>-Element, das signifikanten Inhalt enthält, der es zwingt zu scrollen:

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

Das <main>-Element kann durch eine Kombination von CSS-Eigenschaften in einen Scroll-Container umgewandelt werden, zum Beispiel:

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

Wir können dann das Scroll-Snapping-Verhalten auf den scrollenden Inhalt implementieren, indem wir die scroll-snap-type-Eigenschaft auf das <html>-Element anwenden:

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

Der folgende JavaScript-Ausschnitt würde das scrollsnapchanging-Ereignis auf dem HTML-Dokument auslösen, wenn ein Kind des <main>-Elements ein anstehendes Snap-Ziel wird. In der Handler-Funktion setzen wir eine pending-Klasse auf das Kind, das durch die snapTargetBlock-Eigenschaft referenziert wird, die verwendet werden könnte, um es anders zu stylen, wenn das Ereignis ausgelöst wird.

js
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");
});

Am Anfang der Funktion wählen wir alle Elemente aus, die zuvor die pending-Klasse hatten, und entfernen sie, damit nur das aktuellste anstehende Snap-Ziel gestylt wird.

Spezifikationen

Specification
CSS Scroll Snap Module Level 2
# scrollsnapchanging

Browser-Kompatibilität

Siehe auch