CKTIS / HTML
onscroll — scrollgebeurtenissen afhandelen
Het onscroll-attribuut bevat JavaScript dat wordt uitgevoerd wanneer een scroll-gebeurtenis wordt ontvangen. Zo kan een element op scrollen reageren, maar het attribuut maakt zelf geen scrollbaar gebied.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<div onscroll="/* JavaScript statements */">...</div>onscroll is een globaal attribuut voor het afhandelen van de gebeurtenis scroll. De waarde is de inhoud van een JavaScript-functie, geen URL. Het attribuut maakt zelf niets scrollbaar; het voorbeeld maakt een scrollbaar gebied door de hoogte te beperken en overflow:auto in te stellen.
Verwar het HTML-attribuut niet met de JavaScript-eigenschap element.onscroll, waaraan een functie of null wordt toegewezen. Beide vormen gebruiken dezelfde handlerplek. Bij body- en frameset-elementen verwijst onscroll naar de handler van Window, niet naar een onafhankelijke handler op dat element.
Content Security Policy kan handlers blokkeren die in attributen zijn geschreven. In het voorbeeld is de statusparagraaf aanvankelijk leeg. Het script scrolt de inhoud van het vak door box.scrollHeight toe te wijzen aan box.scrollTop en activeert vervolgens een synthetische scroll-gebeurtenis met box.dispatchEvent(new Event('scroll')). De handler schrijft scroll: offset changed in de paragraaf zonder dat je handmatig hoeft te scrollen. Met die melding kun je het resultaat controleren zonder uit te gaan van een bepaald aantal gebeurtenissen.
Voorbeelden
<!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>Resultaat
scroll: offset changed
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.