Window.scrollBy()
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.
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
| Spécification |
|---|
| CSSOM View Module # dom-window-scrollby |