Window.scroll()
Baseline
Large disponibilité
*
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.
La méthode Window.scroll() permet de faire défiler la fenêtre jusqu'à un endroit donné du document.
Syntaxe
window.scroll(x, y);
window.scroll(options);
Paramètres
x-
Le numéro de pixel sur l'axe horizontal du document qu'on souhaite avoir affiché dans le coin supérieur gauche.
y-
Le numéro de pixel sur l'axe vertical du document qu'on souhaite avoir affiché dans le coin supérieur gauche.
Ou avec options :
options-
Un dictionnaire qui contient les paramètres suivants :
top-
Indique le nombre de pixels sur l'axe vertical le long desquels faire défiler la fenêtre ou l'élément.
left-
Indique le nombre de pixels sur l'axe horizontal le long desquels faire défiler la fenêtre ou l'élément.
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)
Exemples
<!-- On place le 100e pixel, sur l'axe vertical, en haut de la fenêtre -->
<button onclick="scroll(0, 100);">
Cliquez pour faire défiler jusqu'au 100e pixel
</button>
Avec options :
window.scroll({
top: 100,
left: 100,
behavior: "smooth",
});
Notes
Window.scrollTo() est en pratique identique à cette méthode. Pour le défilement relatif, voir les méthodes Window.scrollBy(), Window.scrollByLines(), et Window.scrollByPages().
Pour faire défiler les éléments, voir Element.scrollTop et Element.scrollLeft.
Spécifications
| Spécification |
|---|
| CSSOM View Module # dom-window-scroll |