Element.scrollTop

The Element.scrollTop property gets or sets the number of pixels that the content of an element is scrolled upward. An element's scrollTop is a measurement of the distance of an element's top to its topmost visible content. When an element content does not generate a vertical scrollbar, then its scrollTop value defaults to 0.

Syntax

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

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

// 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 is non-scrollable), scrollTop is set to 0.
• If set to a value less than 0, scrollTop is set to 0.
• If set to a value greater than the maximum that the content can be scrolled, scrollTop is set to the maximum.

Example

Specifications

Browser compatibility

References

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