MDN wants to learn about developers like you: https://qsurvey.mozilla.com/s3/MDN-dev-survey

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.
Working Draft  

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Microsoft Edge Opera Safari (WebKit)
Basic support (Yes) (Yes) Não suportado (Yes) (Yes) (Yes)
Feature Android Android Webview Firefox Mobile (Gecko) Firefox OS IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support ? (Yes) ? ? ? ? ? (Yes)

 

Veja também

Etiquetas do documento e colaboradores

 Colaboradores desta página: Jerffersonferreira
 Última atualização por: Jerffersonferreira,