Propriété scrollTop du DOM HTML
Exemple
Obtenez le nombre de pixels de défilement horizontal et vertical du contenu d'un élément <div> :
var elmnt = document.getElementById("myDIV");
var x = elmnt.scrollLeft;
var y = elmnt.scrollTop;
Plus d'exemples "Essayez-le vous-même" ci-dessous.
Définition et utilisation
La propriété scrollTop définit ou renvoie le nombre de pixels de défilement vertical du contenu d'un élément.
Astuce : Utilisez la propriété scrollLeft pour définir ou renvoyer le nombre de pixels de défilement horizontal du contenu d'un élément.
Astuce : Pour ajouter des barres de défilement à un élément, utilisez la propriété CSS overflow .
Astuce : L' événement onscroll se produit lorsque la barre de défilement d'un élément défile.
Prise en charge du navigateur
| Property | |||||
|---|---|---|---|---|---|
| scrollTop | Yes | Yes | Yes | Yes | Yes |
Syntaxe
Renvoyez la propriété scrollTop :
element.scrollTop
Définissez la propriété scrollTop :
element.scrollTop = pixels
Valeurs de propriété
| Value | Description |
|---|---|
| pixels |
Specifies the number of pixels the element's content is scrolled vertically. Special notes:
|
Détails techniques
| Valeur de retour : | Un nombre, représentant le nombre de pixels de défilement vertical du contenu de l'élément |
|---|
Plus d'exemples
Exemple
Faites défiler le contenu d'un élément <div> jusqu'à 50 pixels horizontalement et 10 pixels verticalement :
var elmnt = document.getElementById("myDIV");
elmnt.scrollLeft = 50;
elmnt.scrollTop = 10;
Exemple
Faites défiler le contenu d'un élément <div> de 50 pixels horizontalement et de 10 pixels verticalement :
var elmnt = document.getElementById("myDIV");
elmnt.scrollLeft += 50;
elmnt.scrollTop += 10;
Exemple
Faites défiler le contenu de <body> de 30 pixels horizontalement et de 10 pixels verticalement :
var body = document.body; // Safari
var html = document.documentElement; //
Chrome, Firefox, IE and Opera places the overflow at the <html> level, unless else is specified. Therefore, we use the
documentElement property for these browsers
body.scrollLeft += 30;
body.scrollTop += 10;
html.scrollLeft += 30;
html.scrollTop += 10;
Exemple
Basculer entre les noms de classe sur différentes positions de défilement - Lorsque l'utilisateur fait défiler 50 pixels à partir du haut de la page, le nom de classe "test" sera ajouté à un élément (et supprimé lors d'un nouveau défilement vers le haut).
window.onscroll = function() {myFunction()};
function myFunction() {
if (document.body.scrollTop > 50 || document.documentElement.scrollTop > 50) {
document.getElementById("myP").className = "test";
} else {
document.getElementById("myP").className = "";
}
}
Exemple
Faites glisser un élément lorsque l'utilisateur a fait défiler 350 pixels depuis le haut de la page (ajoutez la classe slideUp) :
window.onscroll = function() {myFunction()};
function myFunction() {
if (document.body.scrollTop > 350 || document.documentElement.scrollTop > 350) {
document.getElementById("myImg").className = "slideUp";
}
}
Exemple
Dessinez un triangle sur le parchemin :
<!-- Use SVG to draw the triangle (has to be <path>) -->
<svg id="mySVG">
<path fill="none" stroke="red" stroke-width="3" id="triangle" d="M150 0 L75 200 L225 200 Z">
</svg>
<script>
// Get the id of the <path> element and the length of <path>
var triangle = document.getElementById("triangle");
var length = triangle.getTotalLength();
// The start position of the drawing
triangle.style.strokeDasharray = length;
// Hide the triangle by offsetting dash. Remove this line to show the triangle before scroll draw
triangle.style.strokeDashoffset = length;
// Find scroll percentage on scroll (using cross-browser properties), and offset dash same amount as percentage scrolled
window.addEventListener("scroll", myFunction);
function myFunction() {
var scrollpercent = (document.body.scrollTop + document.documentElement.scrollTop) / (document.documentElement.scrollHeight - document.documentElement.clientHeight);
var draw = length * scrollpercent;
// Reverse the drawing (when scrolling upwards)
triangle.style.strokeDashoffset = length - draw;
}
</script>