Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

onscroll — tratar eventos de deslocamento

O atributo onscroll contém JavaScript executado quando é recebido um evento scroll. Permite que um elemento reaja ao deslocamento, mas não cria, por si só, uma área deslocável.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

<div onscroll="/* JavaScript statements */">...</div>

onscroll é um atributo global de tratamento do evento scroll. O seu valor é o corpo de uma função JavaScript, não um URL. O atributo não torna nada deslocável por si só; o exemplo cria uma área deslocável limitando a sua altura e definindo overflow:auto.

Não confundas o atributo HTML com a propriedade JavaScript element.onscroll, à qual se atribui uma função ou null. Ambas as formas usam a mesma posição reservada à função de tratamento do evento. Nos elementos body e frameset, onscroll refere-se à função de tratamento do evento do objeto Window, e não a uma função de tratamento independente desse elemento.

A Content Security Policy pode bloquear funções de tratamento de eventos escritas em atributos. No exemplo, o parágrafo de estado está inicialmente vazio. O script desloca o conteúdo da caixa atribuindo box.scrollHeight a box.scrollTop e, em seguida, dispara um evento scroll sintético com box.dispatchEvent(new Event('scroll')). A função de tratamento do evento escreve scroll: offset changed no parágrafo sem ser necessário deslocar o conteúdo manualmente. A mensagem permite verificar o resultado sem pressupor um número específico de eventos.

Exemplos

<!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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes