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

js
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 douceur
  • instant : le défilement devrait se produire instantanément, en un seul saut
  • auto : le comportement de défilement est déterminé par la valeur calculée de (scroll-behavior)

Valeur de retour

Aucune (undefined).

Exemples

Usage simple

js
window.scrollTo(0, 1000);

En utilisant options

js
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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
scrollTo
options.behavior parameter
options.left parameter
options.top parameter

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
See implementation notes.