Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
element.scrollIntoView
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 janvier 2020.
* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.
La méthodeElement.scrollIntoView() fait défiler la page de manière à rendre l'élément visible.
Dans cet article
Syntaxe
element.scrollIntoView();element.scrollIntoView(alignToTop); // Paramètre booléenelement.scrollIntoView(scrollIntoViewOptions); // Paramètre d'objetParamètres
alignToTopFacultatifest une valeur
Booleanoptionnelle qui :- si elle vaut
true(vrai), aligne l'élément avec le haut de la zone visible de l'ancêtre défilable. Correspond àscrollIntoViewOptions: {block: "start", inline: "nearest"}. C'est la valeur par défaut. - Si elle vaut
false(faux), celui-ci sera aligné en bas de la zone visible de l'ancêtre défilable. Correspond àscrollIntoViewOptions: {block: "end", inline: "nearest"}.
- si elle vaut
scrollIntoViewOptionsFacultatifExpérimentalEst un objet qui a les propriétés suivantes :
behaviorFacultatifDéfinit l'animation de transition qui peut être
"auto","instant"ou"smooth". Par défaut :"auto".blockFacultatifL'une des options
"start","center","end"ou"nearest". Par défaut :"start".inlineFacultatifL'une des options
"start","center","end"ou"nearest". Par défaut :"nearest".
Exemple
var element = document.getElementById("box");element.scrollIntoView();element.scrollIntoView(false);element.scrollIntoView({ block: "end" });element.scrollIntoView({ behavior: "smooth", block: "end", inline: "nearest" });Notes
L'élément peut ne pas être aligné complètement avec le haut ou le bas, selon la disposition des autres éléments.
Spécifications
| Specification |
|---|
| CSSOM View Module> # dom-element-scrollintoview> |