Element: scrollsnapchange event

فهرست فصل‌ها دانلود آرشیوناشر

MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونه‌کد

{{APIRef}}{{SeeCompatTable}}

The **scrollsnapchange** event of the {{domxref("Element")}} interface is fired on the scroll container at the end of a scrolling operation when a new scroll snap target has been selected, just before the corresponding {{domxref("Element/scrollend_event", "scrollend")}} event fires.

A scrolling operation ends when the user finishes scrolling within a scroll container — for example using a touch gesture or by dragging the mouse pointer on a scroll bar — and releases the gesture.

Syntax

Use the event name in {{domxref("EventTarget/addEventListener", "addEventListener()")}}:

js-nolint
addEventListener("scrollsnapchange", (event) => { })

Alternatively, assign to the event handler property of the interface:

js-nolint
onscrollsnapchange = (event) => { }

Event type

A {{domxref("SnapEvent")}}, which inherits from the generic {{domxref("Event")}} type.

Examples

Basic usage

Let's say we have a {{htmlelement("main")}} element containing significant content that causes it to scroll:

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

The <main> element can be turned into a scroll container that snaps to its children when scrolled using a combination of the CSS {{cssxref("scroll-snap-type")}} property and other properties. For example:

css
main {
  width: 250px;
  height: 450px;
  overflow: scroll;
  scroll-snap-type: block mandatory;
}

The following JavaScript snippet would cause the scrollsnapchange event to fire on the <main> element when one of its children becomes a newly-selected snap target. In the handler function, we set a selected class on the child referenced by the {{domxref("SnapEvent.snapTargetBlock")}} property, which could be used to style it to look like it has been selected (for example, with an animation) when the event fires.

js
const scrollingElem = document.querySelector("main");

scrollingElem.addEventListener("scrollsnapchange", (event) => {
  event.snapTargetBlock.classList.add("selected");
});

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • {{domxref("Element/scrollsnapchanging_event", "scrollsnapchanging")}} event
  • {{DOMxRef("Document/scrollend_event", "scrollend")}} event
  • {{domxref("SnapEvent")}}
  • CSS {{cssxref("scroll-snap-type")}} property
  • CSS scroll snap module
  • Using scroll snap events
  • Scroll Snap Events on developer.chrome.com (2024)