Window.scrollY

Baseline Widely available *

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.

La propriétéscrollY de l'objetWindow est une propriété en lecture seule. Elle retourne le nombre de pixels la page actuellement défilés verticalement. Dans les navigateurs modernes, cette valeur est précise au sous-pixel près. Ainsi, la valeur retournée n'est pas forcement un entier.

Syntaxe

var y = window.scrollY;

y est le nombre de pixels verticaux défilés.

Exemple

// make sure and go down to the second pageif (window.scrollY) {  window.scroll(0, 0); // reset the scroll position to the top left of the document.}window.scrollByPages(1);

Notes

Utilisez cette propriété pour être sûre que le document n'as pas été défilé verticalement si vous utilisez les fonctions de défilement tels quewindow.scrollBy,window.scrollByLines, ouwindow.scrollByPages.

La propriétépageYOffset est un alias de la propriétéscrollY:

window.pageYOffset == window.scrollY; // toujours vrai

Pour une compatibilité multi-navigateur, utilisezwindow.pageYOffset à la place dewindow.scrollY.En outre, les anciennes versions d'Internet Explorer (< 9) ne supportent pas non plus la propriété et doit-être utilisé à l'aide d'autres propriétés qui ne sont pas standards. Un exemple entièrement compatible :

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;