Baseline Widely available
The scroll
event fires when an element has been scrolled. To detect when scrolling has completed, see the scrollend
event of Element
.
Use the event name in methods like addEventListener()
, or set an event handler property.
addEventListener("scroll", (event) => { })
onscroll = (event) => { }
Event type
A generic Event
.
The following examples show how to use the scroll
event with an event listener and with the onscroll
event handler property. The setTimeout()
method is used to throttle the event handler because scroll
events can fire at a high rate. For additional examples that use requestAnimationFrame()
, see the Document
scroll
event page.
scroll
with an event listener
The following example shows how to use the scroll
event to detect when the user is scrolling inside an element:
<div
id="scroll-box"
style="overflow: scroll; height: 100px; width: 100px; float: left;">
<p style="height: 200px; width: 200px;">Scroll me!</p>
</div>
<p style="text-align: center;" id="output">Waiting on scroll events...</p>
const element = document.querySelector("div#scroll-box");
const output = document.querySelector("p#output");
element.addEventListener("scroll", (event) => {
output.textContent = "Scroll event fired!";
setTimeout(() => {
output.textContent = "Waiting on scroll events...";
}, 1000);
});
Using onscroll
event handler property
The following example shows how to use the onscroll
event handler property to detect when the user is scrolling:
<div
id="scroll-box"
style="overflow: scroll; height: 100px; width: 100px; float: left;">
<p style="height: 200px; width: 200px;">Scroll me!</p>
</div>
<p id="output" style="text-align: center;">Waiting on scroll events...</p>
const element = document.querySelector("div#scroll-box");
const output = document.querySelector("p#output");
element.onscroll = (event) => {
output.textContent = "Element scroll event fired!";
setTimeout(() => {
output.textContent = "Waiting on scroll events...";
}, 1000);
};
Specifications Browser compatibility See also
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.3