CKTIS / HTML
onscroll — gestionar eventos de desplazamiento
El atributo onscroll contiene JavaScript que se ejecuta cuando se recibe un evento scroll. Permite que un elemento reaccione al desplazamiento, pero no crea por sí mismo un área desplazable.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
<div onscroll="/* JavaScript statements */">...</div>onscroll es un atributo global de gestión del evento scroll. Su valor es el cuerpo de una función JavaScript, no una URL. El atributo no hace que nada sea desplazable por sí solo; el ejemplo crea un área desplazable limitando su altura y estableciendo overflow:auto.
No confundas el atributo HTML con la propiedad JavaScript element.onscroll, a la que se asigna una función o null. Ambas formas utilizan el mismo espacio para el controlador. En los elementos body y frameset, onscroll se refiere al controlador de Window, no a un controlador independiente de ese elemento.
La Content Security Policy puede bloquear los controladores escritos en atributos. En el ejemplo, el párrafo de estado está inicialmente vacío. El script desplaza el contenido del cuadro asignando box.scrollHeight a box.scrollTop y, a continuación, despacha un evento scroll sintético con box.dispatchEvent(new Event('scroll')). El controlador escribe scroll: offset changed en el párrafo sin necesidad de desplazar el contenido manualmente. El mensaje permite comprobar el resultado sin presuponer un número concreto de eventos.
Ejemplos
<!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>Resultado
scroll: offset changed
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.