CKTIS / HTML
onscroll — Scrollereignisse behandeln
Das Attribut onscroll enthält JavaScript, das ausgeführt wird, wenn ein scroll-Ereignis empfangen wird. Damit kann ein Element auf das Scrollen reagieren; einen scrollbaren Bereich erzeugt das Attribut jedoch nicht selbst.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<div onscroll="/* JavaScript statements */">...</div>onscroll ist ein globales Ereignisbehandlungsattribut für scroll. Sein Wert ist der Inhalt einer JavaScript-Funktion, keine URL. Das Attribut macht selbst nichts scrollbar; das Beispiel erzeugt einen scrollbaren Bereich, indem es die Höhe begrenzt und overflow:auto setzt.
Unterscheide das HTML-Attribut von der JavaScript-Eigenschaft element.onscroll, der eine Funktion oder null zugewiesen wird. Beide Formen verwenden denselben Platz für den Handler. Bei body- und frameset-Elementen verweist onscroll auf den Handler des Window-Objekts und nicht auf einen unabhängigen Handler dieses Elements.
Die Content Security Policy kann Handler blockieren, die in Attributen stehen. Im Beispiel ist der Statusabsatz zunächst leer. Das Skript scrollt den Inhalt des Bereichs, indem es box.scrollHeight an box.scrollTop zuweist. Anschließend löst es mit box.dispatchEvent(new Event('scroll')) ein synthetisches scroll-Ereignis aus. Der Handler schreibt scroll: offset changed in den Absatz, ohne dass man manuell scrollen muss. Anhand dieser Meldung lässt sich das Ergebnis überprüfen, ohne eine bestimmte Anzahl von Ereignissen vorauszusetzen.
Beispiele
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Element onscroll handler</title>
<style>
#box { block-size: 6rem; max-inline-size: 20rem; overflow: auto; border: 1px solid; }
#content { block-size: 24rem; background: linear-gradient(#def, #468); }
</style>
</head>
<body>
<div id="box" role="region" aria-label="Scrollable sample" tabindex="0"
onscroll="document.getElementById('result').textContent = event.type + (this.scrollTop > 0 ? ': offset changed' : ': at start')">
<div id="content"></div>
</div>
<p id="result" role="status"></p>
<script>
const box = document.getElementById('box');
box.scrollTop = box.scrollHeight;
// Test the handler now rather than waiting for the browser's queued scroll event.
box.dispatchEvent(new Event('scroll'));
</script>
</body>
</html>Ergebnis
scroll: offset changed
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.