Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti