Window.scrollTo()
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.
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 instantané ou doux. Cette option est une chaine de caractères qui doit être l'une de ces valeurs :
smooth
: le défilement doit s'animer en douceurinstant
: le défilement devrait se produire instantanément, en un seul sautauto
: le comportement de défilement est déterminé par la valeur calculée de (scroll-behavior)
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