[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/fr/docs/Web/API/Window/scroll [Back]  [Original]

Window.scroll() - Les API Web | MDN

Cette page a t traduite partir de l'anglais par la communaut. Vous pouvez contribuer en rejoignant la communaut francophone sur MDN Web Docs.

View in English Always switch to English

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 bnficier de prise en charge variables.

La mthode Window.scroll() permet de faire dfiler la fentre jusqu' un endroit donn du document.

Dans cet article

Syntaxe

js
window.scroll(x, y);
window.scroll(options);

Paramtres

x

Le numro de pixel sur l'axe horizontal du document qu'on souhaite avoir affich dans le coin suprieur gauche.

y

Le numro de pixel sur l'axe vertical du document qu'on souhaite avoir affich dans le coin suprieur gauche.

Ou avec options :

options

Un dictionnaire qui contient les paramtres suivants :

top

Indique le nombre de pixels sur l'axe vertical le long desquels faire dfiler la fentre ou l'lment.

left

Indique le nombre de pixels sur l'axe horizontal le long desquels faire dfiler la fentre ou l'lment.

behavior

Indique si le dfilement devrait tre instantan ou doux. Cette option est une chaine de caractres qui doit tre l'une de ces valeurs :

  • smooth : le dfilement doit s'animer en douceur
  • instant : le dfilement devrait se produire instantanment, en un seul saut
  • auto : le comportement de dfilement est dtermin par la valeur calcule de (scroll-behavior)

Exemples

html
<!-- On place le 100e pixel, sur l'axe vertical, en haut de la fentre -->

<button >
  Cliquez pour faire dfiler jusqu'au 100e pixel
</button>

Avec options :

js
window.scroll({
  top: 100,
  left: 100,
  behavior: "smooth",
});

Notes

Window.scrollTo() est en pratique identique cette mthode. Pour le dfilement relatif, voir les mthodes Window.scrollBy(), Window.scrollByLines(), et Window.scrollByPages().

Pour faire dfiler les lments, voir Element.scrollTop et Element.scrollLeft.

Spcifications

Spcification
CSSOM View Module
# dom-window-scroll

Compatibilit des navigateurs

Voir aussi


Web Proxy Viewer  |  New URL  |  Original Page