posTop property

Sets or retrieves the top position of the object in the units specified by the top attribute.

Syntax

posTop: float

Property values

float

A Floating-point that specifies or receives any valid floating-point number that uses the same CSS Values and Units Reference as the top attribute.

CSS information

Remarks

This property reflects the value of the Cascading Style Sheets (CSS) top attribute for positioned items. This property always returns zero for nonpositioned items because "top" has meaning only when the object is positioned. If the top attribute is not set, the posTop property returns zero. Use the offsetTop property to calculate actual positions within the document area.

Setting this property changes the value of the top position but leaves the units designator for the property unchanged.

Unlike the top property, the posTop property value is a floating-point number, not a string.

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 with CSSOM in Internet Explorer 9.

Examples

This example uses the posTop property to move the first img object up by 10 units.

<script>
  document.all.tags("img").item[0].style.posTop -= 10;
</script>

This example uses a timer to change the value of the posTop in increments of 10.

Code example: http://samples.msdn.microsoft.com/workshop/samples/author/dhtml/refs/pixelWidth.htm

<script>
  function moveThis()
  {
    .
    .
    .

      if (sphere.style.posLeft < 900) {
        sphere.style.posTop += 2;
        sphere.style.posLeft += 2;
        window.setTimeout(moveThis, 1);
      }
  }

  .
  .
  .
</script>

Requirements

See also

defaults

runtimeStyle

style

pixelTop