Element: 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 July 2015.
Das scroll-Ereignis wird ausgelöst, wenn ein Element gescrollt wurde. Um zu erkennen, wann das Scrollen abgeschlossen ist, siehe das scrollend-Ereignis von Element.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignis-Handler-Eigenschaft.
addEventListener("scroll", (event) => { })
onscroll = (event) => { }
Ereignistyp
Ein generisches Event.
Beispiele
Die folgenden Beispiele zeigen, wie man das scroll-Ereignis mit einem Ereignis-Listener und mit der Eigenschaft onscroll verwendet. Die Methode setTimeout() wird verwendet, um den Ereignis-Handler zu drosseln, da scroll-Ereignisse mit hoher Frequenz ausgelöst werden können. Weitere Beispiele, die requestAnimationFrame() verwenden, finden Sie auf der Seite des Document scroll-Ereignisses.
Verwendung von scroll mit einem Ereignis-Listener
Das folgende Beispiel zeigt, wie das scroll-Ereignis verwendet wird, um zu erkennen, wann der Benutzer in einem Element scrollt:
Scroll me!
Waiting on scroll events...
#scroll-box {
overflow: scroll;
height: 100px;
width: 100px;
float: left;
}
#scroll-box p {
height: 200px;
width: 200px;
}
#output {
text-align: center;
}
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);
});
Verwendung der Eigenschaft onscroll für den Ereignis-Handler
Das folgende Beispiel zeigt, wie die onscroll-Ereignis-Handler-Eigenschaft verwendet wird, um zu erkennen, wann der Benutzer scrollt:
Scroll me!
Waiting on scroll events...
#scroll-box {
overflow: scroll;
height: 100px;
width: 100px;
float: left;
}
#scroll-box p {
height: 200px;
width: 200px;
}
#output {
text-align: center;
}
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);
};
Spezifikationen
| Specification |
|---|
| CSSOM View Module # eventdef-document-scroll |
| HTML # handler-onscroll |