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 form of distance measurement regarding 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 has a property of "non-scrollable"), scrollTop is set to 0.
• scrollTop doesn't respond to negative values instead it set itself back to 0.
• If set to value greater than maximum, scrollTop settles itself to maximum value.

Example

Specifications

Specification	Status	Comment
CSS Object Model (CSSOM) View Module The definition of 'scrollTop' in that specification.	Working Draft

Browser compatibility

References

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