Esta página foi traduzida do inglês pela comunidade. Saiba mais e junte-se à comunidade MDN Web Docs.

View in English Always switch to English

GlobalEventHandlers.onscroll

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨julho de 2015⁩.

A propriedade onscroll do GlobalEventHandlers é uma mistura de eventos event handler que processam eventos scroll.

O evento scroll é disparado quando uma visão do documento ou um elemento foi rolado, seja por um usuário, uma API Web, ou o user agent.

Nota: Não confunda onscroll com onwheel: onwheel manipula a rotação da roda do mouse, enquanto onscroll manipula rolagem do conteúdo do objeto.

Sintaxe

target.onscroll = functionRef;

Valor

functionRef é o nome de uma função ou uma expressão de função. A função recebe um UIEvent objeto com um único argumento.

Apenas um manipulador onscroll pode ser associado à um objeto por vez. Para uma maior flexibilidade, você pode passar um scroll evento para o EventTarget.addEventListener() metódo ao invés disso.

Exemplo

Este exemplo monitora rolagens sobre o elemento <textarea>, e registra a posição vertical adequadamente.

HTML

html
<textarea>1 2 3 4 5 6 7 8 9</textarea>
<p id="log"></p>

CSS

css
textarea {
  width: 4rem;
  height: 8rem;
  font-size: 3rem;
}

JavaScript

js
const textarea = document.querySelector("textarea");
const log = document.getElementById("log");

textarea.onscroll = logScroll;

function logScroll(e) {
  log.textContent = `Posição do scroll: ${e.target.scrollTop}`;
}

Resultado

Especificações

Specification
CSSOM View Module
# eventdef-document-scroll
HTML
# handler-onscroll

Compatibilidade com navegadores

Veja também