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

History : propriété scrollRestoration

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 janvier 2020.

La propriété scrollRestoration de l'interface History permet aux applications web de définir explicitement le comportement par défaut de la restauration du défilement lors de la navigation dans l'historique.

Valeur

L'une des valeurs suivantes :

auto

La position sur la page à laquelle l'utilisateur·ice a fait défiler est restaurée.

manual

La position sur la page n'est pas restaurée. L'utilisateur·ice doit faire défiler la page jusqu'à l'emplacement manuellement.

Exemples

Interroger le comportement actuel de la restauration du défilement

js
const scrollRestoration = history.scrollRestoration;
if (scrollRestoration === "manual") {
  console.log(
    "La position sur la page n'est pas restaurée. L'utilisateur·ice devra faire défiler la page manuellement.",
  );
}

Empêcher la restauration automatique de la position sur la page

js
history.scrollRestoration = "manual";

Spécifications

Spécification
HTML
# dom-history-scroll-restoration-dev

Compatibilité des navigateurs