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 September 2020.
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
<textarea>1 2 3 4 5 6 7 8 9</textarea>
<p id="log"></p>
CSS
textarea {
width: 4rem;
height: 8rem;
font-size: 3rem;
}
JavaScript
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 Standard # handler-onscroll |
Compatibilidade com navegadores
BCD tables only load in the browser