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

CKTIS / HTML

onscrollend — tratar o fim da deslocação

O atributo onscrollend associa código JavaScript ao evento scrollend, que indica que a deslocação terminou. Não confundas o nome do atributo com o nome do evento usado com addEventListener().

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

Sintaxe

onscrollend="JavaScript statements"
element.onscrollend = handler;
element.addEventListener("scrollend", handler);

onscrollend é um atributo global de tratamento do evento scrollend. O seu valor é código JavaScript, não um valor booleano. Adicionar o atributo não basta para criar uma área cujo conteúdo se possa deslocar; no exemplo, essa área é criada limitando a altura e usando overflow:auto.

Distingue o atributo HTML onscrollend, a propriedade JavaScript element.onscrollend e o nome do evento "scrollend" passado a addEventListener(). HTML define este manipulador de eventos para elementos HTML e também como propriedade dos objetos Document e Window.

No exemplo, desloca o conteúdo da caixa e aguarda que a deslocação termine. O texto esperado é scrollend. Para experimentar o exemplo, usa um navegador que suporte este evento. Não foi realizado nenhum teste de deslocação interativa. O instantâneo do índice da norma foi consultado em 2026-11-18.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onscrollend example</title>
<div id="box" tabindex="0" style="height:100px;overflow:auto"
     onscrollend="document.getElementById('status').textContent = 'scrollend'">
  <div style="height:400px">Scroll this box.</div>
</div>
<p id="status" role="status">Waiting</p>
</html>

Resultado

scrollend

O texto de estado é inicialmente `Waiting`. Quando a caixa dispara o evento `scrollend`, o manipulador altera o texto para `scrollend`. Num ambiente isolado, verificou-se a estrutura do exemplo e se o resultado esperado decorria do código. A alteração do texto não foi observada através de deslocação interativa.

Fontes