Retrieves the left coordinate of the object clipping region.

Syntax

[ sLeft = ] currentStyle.clipLeft

Possible Values

sLeft

Variant that receives one of the following values. auto Left side of object is fully exposed—that is, the left side is not clipped. 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.

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

Example

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

<SCRIPT>
function setClip(sOptionValue) {
oImage.style.clip="rect(0,100,100,"+sOptionValue+")";
if (oImage.currentStyle.clipLeft == "60px") {
alert("The image has been clipped to 60px.");
}
:
}
</SCRIPT>
:
<IMG ID=oImage SRC="../common/sphere.jpg">
:
Pick an amount to clip the left:
// 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, clipRight, clipTop