Cette traduction est en cours.

Résumé

La propriété scrollY de l'objet Window 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 page 
if (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 functions de défilement tels que window.scrollBy, window.scrollByLines, ou window.scrollByPages.

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

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

Pour une compatibilité multi-navigateur, utilisez window.pageYOffset à la place de window.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;

Spécifications

Spécification Status Commentaire(s)
CSS Object Model (CSSOM) View Module
La définition de 'window.scrollY' dans cette spécification.
Version de travail  

Compatibilité des navigateurs

Nous convertissons les données de compatibilité dans un format JSON. Ce tableau de compatibilité utilise encore l'ancien format car nous n'avons pas encore converti les données qu'il contient. Vous pouvez nous aider en contribuant !

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support (Oui) (Oui) Edge (Oui) (Oui)
Feature Android Android Webview Firefox Mobile (Gecko) Firefox OS IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support ? ? ? ? ? ? ? ?

Voir également

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : blr21560, Buzut, romuleald, cyriil_dev
 Dernière mise à jour par : blr21560,