W3cubDocs

/Web APIs

VisualViewport: scroll event

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨August 2021⁩.

The scroll event of the VisualViewport interface is fired when the visual viewport is scrolled. This allows you to position elements relative to the visual viewport as it is scrolled, which would normally be anchored to the layout viewport.

Syntax

Use the event name in methods like addEventListener(), or set an event handler property.

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

onscroll = (event) => { }

Event type

A generic Event.

Examples

See the Visual Viewport API landing page for a usage demo.

Specifications

Specification
CSSOM View Module>
# eventdef-document-scroll>

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet WebView Android WebView on iOS
scroll_event 62
61–62The onscroll event handler property is not supported.
 79 91 49
48–49The onscroll event handler property is not supported.
 13 62
61–62The onscroll event handler property is not supported.
 68 46
45–46The onscroll event handler property is not supported.
 13 8.0 62
61–62The onscroll event handler property is not supported.
 13

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/VisualViewport/scroll_event