La méthodeWindow.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 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

window.scrollTo(0, 1000);

En utilisantoptions

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éthodesWindow.scrollBy(),Window.scrollByLines(), etWindow.scrollByPages().

Pour le défilement des éléments, voirElement.scrollTop etElement.scrollLeft.

Spécifications

Compatibilité des navigateurs