HTML DOM scrollTop Property

HTMLElement Object Reference Element Object

Example

Get the number of pixels the content of a <div> element is scrolled horizontally and vertically:

var elmnt = document.getElementById("myDIV");
var x = elmnt.scrollLeft;
var y = elmnt.scrollTop;

Try it yourself »

More "Try it Yourself" examples below.


Definition and Usage

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

Tip: Use the scrollLeft property to set or return the number of pixels an element's content is scrolled horizontally.

Tip: To add scrollbars to an element, use the CSS overflow property.


Browser Support

Property
scrollTop Yes Yes Yes Yes Yes


Syntax

Return the scrollTop property:

element.scrollTop

Set the scrollTop property:

element.scrollTop=pixels

Property Values

Value Description
pixels Specifies the number of pixels the element's content is scrolled vertically.

Special notes:
  • If the number is a negative value, the number is set to "0"
  • If the element cannot be scrolled, the number is set to "0"
  • If the number is greater than the maximum allowed scroll amount, the number is set to the maximum number

Technical Details

Return Value: A Number, representing the number of pixels that the element's content has been scrolled vertically


Examples

More Examples

Example

Scroll the contents of a <div> element TO 50 pixels horizontally and 10 pixels vertically:

var elmnt = document.getElementById("myDIV");
elmnt.scrollLeft = 50;
elmnt.scrollTop = 10;

Try it yourself »

Example

Scroll the contents of a <div> element BY 50 pixels horizontally and 10 pixels vertically:

var elmnt = document.getElementById("myDIV");
elmnt.scrollLeft += 50;
elmnt.scrollTop += 10;

Try it yourself »

Example

Scroll the contents of <body> by 30 pixels horizontally and 10 pixels vertically:

document.body.scrollLeft += 30;
document.body.scrollTop += 10;

Try it yourself »


HTMLElement Object Reference Element Object


Color Picker

colorpicker