English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

Método scrollTop() do jQuery

jQuery HTML/Métodos CSS

O método scrollTop() obtém ou configura a posição vertical da barra de rolagem do elemento selecionado.

ao usar o método scrollTop()Obterao definir a posição, ele retornaráo primeiro elemento selecionadoa posição vertical da barra de rolagem.

ao usar o método scrollTop()Configurarao definir a posição, ele retornaráTodos os elementos selecionadosConfigurar a posição vertical da barra de rolagem.

Sintaxe:

Obter a posição da barra de rolagem vertical:

$(selector).scrollTop()

Configurar a posição da barra de rolagem vertical:

$(selector).scrollTop(value)

Exemplo

Obter o scrollTop do DIV:

$("div").scroll(function(){
  $(this).scrollTop();
});
Teste e Veja‹/›

Configurar o scrollTop do DIV:

$("button").click(function(){
  $("div").scrollTop(150);
});
Teste e Veja‹/›

Definir scrollTop do documento:

$("button").click(function(){
  $(document).scrollTop(400);
});
Teste e Veja‹/›

Adicionar rolagem suave ao rolar a página do usuário:

let size = $(".main").height(); // Obter a altura de ".main"
$(window).keydown(function(event) {
  if(event.which === 40) { // Se pressionar a tecla de seta para baixo
    $("html, body").animate({scrollTop: "+=" + size}, 300);
  } else if(event.which === 38) { // Se pressionar a tecla de seta para cima
    $("html, body").animate({scrollTop: "-=" + size}, 300);
  }
});
Teste e Veja‹/›

Valor do Parâmetro

ParâmetroDescrição
valueUm inteiro que indica a nova posição do deslocamento da barra de rolagem

jQuery HTML/Métodos CSS