Tutorials References Menu

jQuery scrollTop() Method

❮ jQuery HTML/CSS Methods

Example

Return the vertical scrollbar position for a <div> element:

$("button").click(function(){
  alert($("div").scrollTop());
});
Try it Yourself »

Definition and Usage

The scrollTop() method sets or returns the vertical scrollbar position for the selected elements.

Tip: When the scrollbar is on the top, the position is 0.

When used to return the position:
This method returns the vertical position of the scrollbar for the FIRST matched element.

When used to set the position:
This method sets the vertical position of the scrollbar for ALL matched elements.


Syntax

Return vertical scrollbar position:

$(selector).scrollTop()

Set vertical scrollbar position:

$(selector).scrollTop(position)

Parameter Description
position Specifies the vertical scrollbar position in pixels

Try it Yourself - Examples

Set the vertical scrollbar position
How to set the vertical scrollbar position for an element.

Toggle between classes on different scroll positions
How to toggle between classes on different scroll positions.

Add smooth scrolling to page anchors
Using animate() together with scrollTop() to add smooth scrolling to links.


❮ jQuery HTML/CSS Methods