scrollTop Property

Sets or retrieves the distance between the top of the object and the topmost portion of the content that is currently visible in the window.

Syntax

HTML N/A

Scripting object.scrollTop [ = iDistance ]

HTML	N/A
Scripting	object.scrollTop [ = iDistance ]

Possible Values

iDistance Integer value representing the distance, in pixels.

The property is read/write with a default value of 0.

Remarks

The property's value is equal to the vertical distance that the content of the object has been scrolled. Although the value can be set to any positive or negative value, if the assigned value is less than zero, the property is set to zero. If the assigned value is greater than the maximum possible, the property is set to the maximum possible.
This property can be set inline but the results may not be consistent while the page is loading.
This property is always zero for objects that do not have scroll bars. For these objects, setting the property has no effect.
When a MARQUEE object is scrolling horizontally its scrollTop property is set to zero, overriding any script setting.
For more information on how to access the dimension and location of elements on the page through the document object model, see Measuring Element Dimension and Location.

Example

The following example shows how the scrollTop property can be used to determine the amount of scrolling done by an object.

Sample Code
<DIV ID=oDiv STYLE="position:absolute; width:200px; height:100px;
overflow:scroll" onclick=alert(this.scrollTop)>
<SPAN STYLE="width:250px"> . . . </SPAN></DIV>
This feature requires Internet Explorer 4.0 or later. Click the icon below to install the latest version. Then reload this page to view the sample.

Applies To

A, ADDRESS, APPLET¹, B, BDO, BIG, BLOCKQUOTE, BODY¹, BUTTON¹, CAPTION¹, CENTER, CITE, CODE, COL, COLGROUP, DD, DFN, DIR, DIV¹, DL, DT, EM, EMBED¹, FIELDSET¹, FORM, HEAD, Hn, HTML, HTMLAREA, I, IMG¹, INPUT type=button¹, INPUT type=checkbox¹, INPUT type=file¹, INPUT type=hidden¹, INPUT type=image¹, INPUT type=password¹, INPUT type=radio¹, INPUT type=reset¹, INPUT type=submit¹, INPUT type=text¹, ISINDEX, KBD, LABEL, LEGEND¹, LI, LISTING, MARQUEE¹, MENU, META, NOBR, OBJECT¹, OL, OPTION, P, PLAINTEXT, PRE, S, SAMP, SCRIPT, SELECT, SMALL, SPAN¹, STRIKE, STRONG, STYLE, SUB, SUP, TABLE¹, TBODY, TD¹, TEXTAREA¹, TFOOT, TH, THEAD, TR¹, TT, U, UL, VAR, XMP
¹Available as of Internet Explorer 4.0 or later. Otherwise, available as of Internet Explorer 5 or later.


A, ADDRESS, APPLET¹, B, BDO, BIG, BLOCKQUOTE, BODY¹, BUTTON¹, CAPTION¹, CENTER, CITE, CODE, COL, COLGROUP, DD, DFN, DIR, DIV¹, DL, DT, EM, EMBED¹, FIELDSET¹, FORM, HEAD, Hn, HTML, HTMLAREA, I, IMG¹, INPUT type=button¹, INPUT type=checkbox¹, INPUT type=file¹, INPUT type=hidden¹, INPUT type=image¹, INPUT type=password¹, INPUT type=radio¹, INPUT type=reset¹, INPUT type=submit¹, INPUT type=text¹, ISINDEX, KBD, LABEL, LEGEND¹, LI, LISTING, MARQUEE¹, MENU, META, NOBR, OBJECT¹, OL, OPTION, P, PLAINTEXT, PRE, S, SAMP, SCRIPT, SELECT, SMALL, SPAN¹, STRIKE, STRONG, STYLE, SUB, SUP, TABLE¹, TBODY, TD¹, TEXTAREA¹, TFOOT, TH, THEAD, TR¹, TT, U, UL, VAR, XMP ¹Available as of Internet Explorer 4.0 or later. Otherwise, available as of Internet Explorer 5 or later.