top Attribute | top Property

Sets or retrieves the position of the object relative to the top of the next positioned object in the document hierarchy.

Syntax

HTML Scripting

{ top : sTop }

object.style.top [ = sTop ]

Possible Values

sTop

Variant that specifies or receives one of the following values:

auto	Default. Default position according to the regular HTML layout of the page.
length	Floating-point number, followed by an absolute units designator ( cm , mm , in , pt , pc , or px ) or a relative units designator ( em or ex ). For more information about the supported length units, see CSS Length Units Reference .
percentage	Integer, followed by a percent sign (%). This value is a percentage of the height of the parent object.

The property is read/write for all objects except the following, for which it is read-only: currentStyle . The property has a default value of auto . The Cascading Style Sheets (CSS) attribute is not inherited.

Expressions can be used in place of the preceding value(s), as of Microsoft® Internet Explorer 5. For more information, see About Dynamic Properties .

Remarks

The top attribute should be used only when the position attribute is set; otherwise, the value of the top attribute is ignored.

Because the value of the top property is a string, you cannot use the property in script to calculate the position of the object in the document; instead, use the pixelTop or the posTop property.

For more information about how to access the dimension and location of objects on the page through the Dynamic HTML (DHTML) Document Object Model (DOM), see Measuring Element Dimension and Location .

Examples

The following examples use the top attribute and the top property to change the position of the object.

This example uses an inline style to set the position of a div object.

This example uses inline script to change the position of the image set by an inline style. The change occurs during onmouseover and onmouseout events.

Standards Information

This property is defined in Cascading Style Sheets (CSS), Level 2 (CSS2) .

Applies To

Platform Version

Win16:	4.0
Win32:	4.0
Windows CE:	4.0
Unix:	4.0
Mac:	4.0

A , ADDRESS , APPLET , B , BIG , BLOCKQUOTE , BUTTON , CENTER , CITE , CODE , currentStyle , CUSTOM , DD , defaults , DFN , DIR , DIV , DL , DT , EM , EMBED , FIELDSET , FONT , FORM , hn , HR , I , IFRAME , IMG , INPUT type=button , INPUT type=checkbox , INPUT type=file , 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 , OBJECT , OL , P , PRE , runtimeStyle , S , SAMP , SELECT , SMALL , SPAN , STRIKE , STRONG , style , SUB , SUP , TABLE , TEXTAREA , TT , U , UL , VAR , XMP

Home | Top | Website design | JavaScript Editor

Get Advanced
JavaScript and Ajax Editor,
Validator and Debugger!
1st JavaScript Editor.

→