clipTop Property

Internet Development Index

Retrieves the top coordinate of the object clipping region.

Syntax

[ sTop = ] currentStyle.clipTop

Possible Values

sTopVariant that receives one of the following values.
autoTop side of object is fully exposed—that is, the top side is not clipped.
lengthFloating-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.

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="../common/sphere.jpg">
:
Pick an amount to clip the top:
// the option value is sent as an argument:
<SELECT onchange="setClip(value)">
<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