Gets the top coordinate of the object clipping region.

Syntax

[ sTop = ] currentStyle.clipTop

Possible Values

sTop

String that receives one of the following values. auto The top side of object is fully exposed—that is, the top side is not clipped. length A floating-point number, followed by an absolute units designator (cm, mm, in, pt, or pc), or a relative units designator (em, ex, or px). For more information about the supported length units, see CSS Length Units.

The property is read-only. The property has no default value.

Example

This example demonstrates how to read the clipTop property from the currentStyle object of an image.

<SCRIPT>
function setClip(sOptionValue) {
    oImage.style.clip="rect("+sOptionValue+",100,100,0)";
    if (oImage.currentStyle.clipTop == "60px") {
        alert("The image has been clipped to 60px.");
        }
:
}	 
</SCRIPT>
:
<IMG ID=oImage SRC="/workshop/graphics/sphere.jpg">
:
Pick an amount to clip the top: 
    // the option value is sent as an argument:
<SELECT >
<OPTION VALUE=100>reset </OPTION>
<OPTION VALUE=40>40px </OPTION>
<OPTION VALUE=50>50px </OPTION>
<OPTION VALUE=60>60px </OPTION>
</SELECT>

This feature requires Microsoft® Internet Explorer 5 or later. Click the following icon to install the latest version. Then reload this page to view the sample.

Standards Information

There is no public standard that applies to this property.

Applies To

currentStyle

See Also

clip, clipBottom, clipLeft, clipRight