clipLeft Property

Retrieves the left coordinate of the object clipping region.

Syntax

HTML	N/A
Scripting	[ sLeft = ] currentStyle.clipLeft

Possible Values

sLeft

String that specifies 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 with no default value.

Example

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

Sample Code

<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="/workshop/graphics/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 Internet Explorer 5 or later. Click the icon below to install the latest version. Then reload this page to view the sample.

Applies To

[ Object Name ] Platform Version Win16: Win32: Mac: Unix: WinCE: Version data is listed when the mouse hovers over a link, or the link has focus.	currentStyle

See Also

clip, clipBottom, clipRight, clipTop