Window.scrollY
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.
Sumario
Retorna el número de píxeles que han sido desplazados en el documento mediante el scroll vertical.
Sintaxis
var y = window.scrollY;
y
es el número de píxeles que se han desplazado actualmente desde el extremo superior de la página.
Ejemplo
// Asegurate de bajar a la segunda página
if (window.scrollY) {
window.scroll(0, 0); // Restablece la posición de desplazamiento en la parte superior izquierda del documento
}
window.scrollByPages(1);
Notas
Usa esta propiedad para verificar que al documento no se le ha hecho scroll, si estás usando funciones relativas de scroll como window.scrollBy
, window.scrollByLines
, o window.scrollByPages
.
La propiedad pageYOffset
es un alias para la propiedad scrollY
:
window.pageYOffset == window.scrollY; // Siempre verdadero
Para compatibilidad entre navegadores, es recomendable usar window.pageYOffset en vez de window.scrollY. Adicionalmente, tener en cuenta que versiones más viejas de Internet Explorer (<9) no soportan del todo la propiedad y debe ser solucionado usando propiedades no estandarizadas . Un ejemplo totalmente compatible entre navegadores:
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;
Especificación
- CSSOM View Module: window.scrollY (Editor's Draft)