Element.scrollTop

The Element.scrollTop property gets or sets the number of pixels that an element's content is scrolled vertically.

An element's scrollTop value is a measurement of the distance from the element's top to its topmost visible content. When an element's content does not generate a vertical scrollbar, then its scrollTop value is 0.

Syntax

// Get the number of pixels scrolled
var  intElemScrollTop = someElement.scrollTop;

After running this code, intElemScrollTop is an integer corresponding to the number of pixels that the element's content has been scrolled upwards.

// Set the number of pixels scrolled
element.scrollTop = intValue;

scrollTop can be set to any integer value, with certain caveats:

• If the element can't be scrolled (e.g. it has no overflow or if the element has a property of  "non-scrollable"), scrollTop is 0.
• scrollTop  doesn't respond to negative values; instead, it sets itself back to 0.
• If set to a value greater than the maximum available for the element, scrollTop settles itself to the maximum value.

Example

Specifications

Browser compatibility

References

• W3C Draft CSSOM View Module
• MSDN's scrollTop definition
• HTML DOM scrollTop Property
• MSDN's Measuring Element Dimension and Location