Window.scroll()
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 doux (
smooth
), ou s'il devrait avoir lieu instantanément, en un seul saut (auto
, il s'agit de la valeur par défaut).
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
Specification |
---|
CSSOM View Module # dom-window-scroll |
Compatibilité des navigateurs
BCD tables only load in the browser