CSS Property: clip
[this page | pdf | back links]
The CSS (CSS2) clip property indicates what to do
with an image that is larger than its containing element. The clip property
allows you to specify a rectangle to clip an absolutely positioned element. The
rectangle is specified by four coordinates, all from the top-left corner of the
element being clipped. The clip property does not work if the overflow
property is set to visible.
Valid property values
(other than inherit
and initial) are:
|
Value
|
Description
|
|
auto
|
(default value). No
clipping is applied
|
|
shape
|
Clips an element to
within a given shape
|
|
Default Value:
|
auto
|
|
JavaScript syntax:
|
e.g. object.style.clip="rect(0px,10px,10px,5px)"
|
|
Inherited:
|
No
|
|
Animatable:
|
Yes
|
At the time of writing, the
only valid type of value for shape was rect(top,
right, bottom, left) where top, right, bottom
and left are CSS
lengths.
EXAMPLE:
HTML USED IN THIS EXAMPLE:
<!DOCTYPE html>
<html> <!-- Copyright (c) Nematrian Limited 2018 -->
<head>
<style>
p {border: 1px solid green; width: 300px; height: 105px;}
img.x1 {position: absolute; clip: rect(20px,60px,90px,10px);}
</style>
</head>
<body>
Element with default property<br>
<p><img src="Pictures/Shape1.jpg"></p>
Element set using in-file HTML style
<p><img class="x1" src="Pictures/Shape1.jpg"></p>
Property set using JavaScript
<p><img id="x2" src="Pictures/Shape1.jpg"></p>
<script>
document.getElementById("x2").style.position = "absolute"
document.getElementById("x2").style.clip =
"rect(20px,60px,90px,10px)";
</script>
</body>
</html>
|
FUNCTION THAT MAY ASSIST IN TESTING WHETHER FEATURE IS SUPPORTED:
function isSupportedCSSPropertyClip() {
var x = document.createElement("DIV"); x.style.clip = "rect(20px,60px,90px,10px)"; return (window.getComputedStyle(x, null).clip == "rect(20px,60px,90px,10px)");
} |
NAVIGATION LINKS
Contents | Prev | Next | CSS Properties