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
(en-US), 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 |
Compatibilidade com navegadores
BCD tables only load in the browser