Element : méthode scrollIntoViewIfNeeded()
Non standard: Cette fonctionnalité n'est pas standardisée. Nous déconseillons d'utiliser des fonctionnalités non standard en production, car leur prise en charge par les navigateurs est limitée, et elles peuvent être modifiées ou supprimées. Toutefois, elles peuvent constituer une alternative appropriée dans certains cas où aucune option standard n'existe.
La méthode scrollIntoViewIfNeeded() de l'interface Element fait défiler l'élément courant dans la zone visible de la fenêtre du navigateur si celui-ci n'est pas déjà dans la zone visible. Si l'élément est déjà dans la zone visible de la fenêtre du navigateur, aucun défilement n'a lieu. Cette méthode est une variation propriétaire de la méthode standard Element.scrollIntoView().
Syntaxe
scrollIntoViewIfNeeded()
scrollIntoViewIfNeeded(centerIfNeeded)
Paramètres
centerIfNeededFacultatif-
Une valeur booléenne facultative dont la valeur par défaut est
true:- Si
true, l'élément est aligné de sorte à être centré dans la zone défilable visible de l'ancêtre. - Si
false, l'élément est aligné sur le bord le plus proche de la zone défilable visible de l'ancêtre. Selon le bord de la zone visible le plus proche de l'élément, le haut de l'élément est aligné sur le bord supérieur de la zone visible, ou le bord inférieur de l'élément est aligné sur le bord inférieur de la zone visible.
- Si
Valeur de retour
Aucune (undefined).
Exemples
const element = document.getElementById("mon-el");
element.scrollIntoViewIfNeeded(); // Centre l'element dans la zone visible
element.scrollIntoViewIfNeeded(false); // Aligne l'element sur le bord le plus proche dans la zone visible
Spécifications
Ne fait partie d'aucune spécification. C'est une méthode propriétaire propre à WebKit.
Compatibilité des navigateurs
Voir aussi
- W3C CSSOM bogue 17152 : Support centrant un élément lors du défilement dans la vue (angl.) (demande de fonctionnalité pour un équivalent standardisé à
scrollIntoViewIfNeeded)