Window.scrollTo()
La méthode Window.scrollTo()
permet de faire défiler la fenêtre pour atteindre les coordonnées données dans le document.
Syntaxe
scrollTo(x-coord, y-coord)
scrollTo(options)
Paramètres
x-coord
-
Le pixel sur l'axe horizontal du document dont on veut qu'il soit affiché dans le coin supérieur gauche.
y-coord
-
Le pixel sur l'axe vertical du document dont on veut qu'il soit affiché dans le coin supérieur gauche.
ou
options
-
Un dictionnaire avec les paramètres suivants :
top
-
Indique le nombre de pixels le long desquels faire défiler la fenêtre ou l'élément sur l'axe vertical.
left
-
Indique le nombre de pixels le long desquels faire défiler la fenêtre ou l'élément sur l'axe horizontal.
behavior
-
Indique si le défilement devrait être doux (valeur
smooth
), ou s'il devrait avoir lieu instantanément, en une seule fois (valeurauto
, qui est la valeur par défaut).
Valeur de retour
Aucune (undefined
).
Exemples
Usage simple
window.scrollTo(0, 1000);
En utilisant options
window.scrollTo({
top: 100,
left: 100,
behavior: 'smooth'
});
Notes
Window.scroll()
est la même que cette méthode. Pour le défilement relatif, voir les méthodes Window.scrollBy()
, Window.scrollByLines()
, et Window.scrollByPages()
.
Pour le défilement des éléments, voir Element.scrollTop
et Element.scrollLeft
.
Spécifications
Specification |
---|
CSSOM View Module # dom-window-scrollto |
Compatibilité des navigateurs
BCD tables only load in the browser