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.

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

onscroll = (event) => { }

Event type

A generic Event.

Examples

See the VisualViewport landing page for a usage demo.

Specifications

Specification

CSSOM View Module
# eventdef-document-scroll

Browser compatibility

Enable JavaScript to view this browser compatibility table.

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on Nov 19, 2025 by MDN contributors.

View this page on GitHub • Report a problem with this content

CSSOM view API
VisualViewport
Instance properties
Events
1. resize
2. scroll
3. scrollend
Inheritance
1. EventTarget
Related pages for CSSOM view API
Guides
1. Coordinate systems
2. Viewport concepts