Propriedade HTML DOM scrollTop
Exemplo
Obtenha o número de pixels que o conteúdo de um elemento <div> é rolado horizontalmente e verticalmente:
var elmnt = document.getElementById("myDIV");
var x = elmnt.scrollLeft;
var y = elmnt.scrollTop;
Mais exemplos de "Experimente você mesmo" abaixo.
Definição e uso
A propriedade scrollTop define ou retorna o número de pixels em que o conteúdo de um elemento é rolado verticalmente.
Dica: Use a propriedade scrollLeft para definir ou retornar o número de pixels em que o conteúdo de um elemento é rolado horizontalmente.
Dica: Para adicionar barras de rolagem a um elemento, use a propriedade CSS overflow .
Dica: O evento onscroll ocorre quando a barra de rolagem de um elemento está sendo rolada.
Suporte ao navegador
Property | |||||
---|---|---|---|---|---|
scrollTop | Yes | Yes | Yes | Yes | Yes |
Sintaxe
Retorne a propriedade scrollTop:
element.scrollTop
Defina a propriedade scrollTop:
element.scrollTop = pixels
Valores de propriedade
Value | Description |
---|---|
pixels |
Specifies the number of pixels the element's content is scrolled vertically. Special notes:
|
Detalhes técnicos
Valor de retorno: | Um número, representando o número de pixels em que o conteúdo do elemento foi rolado verticalmente |
---|
Mais exemplos
Exemplo
Role o conteúdo de um elemento <div> PARA 50 pixels horizontalmente e 10 pixels verticalmente:
var elmnt = document.getElementById("myDIV");
elmnt.scrollLeft = 50;
elmnt.scrollTop = 10;
Exemplo
Role o conteúdo de um elemento <div> 50 pixels horizontalmente e 10 pixels verticalmente:
var elmnt = document.getElementById("myDIV");
elmnt.scrollLeft += 50;
elmnt.scrollTop += 10;
Exemplo
Role o conteúdo de <body> em 30 pixels na horizontal e 10 pixels na vertical:
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;
Exemplo
Alternar entre nomes de classe em diferentes posições de rolagem - Quando o usuário rolar para baixo 50 pixels a partir do topo da página, o nome da classe "teste" será adicionado a um elemento (e removido quando rolar para cima novamente).
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 = "";
}
}
Exemplo
Deslize em um elemento quando o usuário tiver rolado para baixo 350 pixels da parte superior da página (adicione a classe slideUp):
window.onscroll = function() {myFunction()};
function myFunction() {
if (document.body.scrollTop > 350 || document.documentElement.scrollTop > 350) {
document.getElementById("myImg").className = "slideUp";
}
}
Exemplo
Desenhe um triângulo no pergaminho:
<!-- 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>