Window.scrollY

Sumário

Retorna o número de pixels que o documento já rolou verticalmente.

Sintaxe

var y = window.scrollY;
  • y é o número atual de pixels que o documento rolou a partir do topo.

Exemplo

// verificar e ir para a segunda página
if (window.scrollY) {
  window.scroll(0, 0);  // reinicia a posição do scroll para a posição superior esquerda do documento.
}

window.scrollByPages(1);

Notas

Utilize esta propriedade para verificar se o documento já foi rolado quando funções de rolagem relativa, tais como window.scrollBy, window.scrollByLines, ou window.scrollByPages, forem utilizadas.

A propriedade pageYOffset é um alias para scrollY:

window.pageYOffset == window.scrollY; // always true

For cross-browser compatibility, use window.pageYOffset instead of window.scrollY. Additionally, older versions of Internet Explorer (< 9) do not support either property and must be worked around by checking other non-standard properties. A fully compatible example:

Para compatibilidade cross-browser, utilize window.pageYOffset em vez de window.scrollY. Além disso, versões inferiores do Internet Explorer 9 não suportam ambas as propriedades, e deve ser contornado verificando outras propriedades não padronizadas.

var supportPageOffset = window.pageXOffset !== undefined;
var isCSS1Compat = ((document.compatMode || "") === "CSS1Compat");

var x = supportPageOffset ? window.pageXOffset : isCSS1Compat ? document.documentElement.scrollLeft : document.body.scrollLeft;
var y = supportPageOffset ? window.pageYOffset : isCSS1Compat ? document.documentElement.scrollTop : document.body.scrollTop;

Especificação

Specification Status Comment
CSS Object Model (CSSOM) View Module
The definition of 'window.scrollY' in that specification.
Rascunho atual

Browser compatibility

BCD tables only load in the browser

Veja também