CKTIS / HTML
onscroll — gestire gli eventi di scorrimento
L’attributo onscroll contiene JavaScript eseguito quando viene ricevuto un evento scroll. Consente a un elemento di reagire allo scorrimento, ma non crea da solo un’area scorrevole.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<div onscroll="/* JavaScript statements */">...</div>onscroll è un attributo globale per la gestione dell’evento scroll. Il suo valore è il corpo di una funzione JavaScript, non un URL. L’attributo non rende scorrevole alcunché da solo; l’esempio crea un’area scorrevole limitandone l’altezza e impostando overflow:auto.
Non confondere l’attributo HTML con la proprietà JavaScript element.onscroll, a cui si assegna una funzione o null. Entrambe le forme usano lo stesso spazio per il gestore. Negli elementi body e frameset, onscroll si riferisce al gestore di Window, non a un gestore indipendente dell’elemento.
La Content Security Policy può bloccare i gestori scritti negli attributi. Nell’esempio, il paragrafo di stato è inizialmente vuoto. Lo script fa scorrere il contenuto del riquadro assegnando box.scrollHeight a box.scrollTop, poi invia un evento scroll sintetico con box.dispatchEvent(new Event('scroll')). Il gestore scrive scroll: offset changed nel paragrafo senza bisogno di scorrere manualmente. Il messaggio permette di verificare il risultato senza presupporre un numero specifico di eventi.
Esempi
<!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>Risultato
scroll: offset changed
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.