Window.scrollBy()
Baseline
Widely available
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.
Fait défiler le document dans la fenêtre du nombre de pixels passé en paramètre.
Syntaxe
window.scrollBy(X, Y);
Paramètres
Xest le nombre en pixels pour le défilement horizontal.Yest le nombre en pixels pour le défilement vertical.
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)
Des coordonnées positives feront défiler à droite et vers le bas de la page. Des coordonnées négatives feront défiler à gauche et vers le haut de la page.
Exemples
// fait défiler d'une page
window.scrollBy(0, window.innerHeight);
Notes
window.scrollBy fait défiler en fonction d'un nombre précis, alors que window.scroll fait défiler vers une position absolue dans le document. Voir aussi window.scrollByLines, window.scrollByPages
Spécifications
| Specification |
|---|
| CSSOM View Module # dom-window-scrollby |