You’re reading the English version of this content since no translation exists yet for this locale. Help us translate this article!
The clip
CSS property defines what portion of an element is visible. The clip
property applies only to absolutely positioned elements, that is elements with position:absolute
or position:fixed
.
/* Keyword value */ clip: auto; /* <shape> values */ clip: rect(1px 10em 3rem 2ch); clip: rect(1px, 10em, 3rem, 2ch); /* Global values */ clip: inherit; clip: initial; clip: unset;
Syntax
Note: Where possible, authors are encouraged to use the newer clip-path
property instead.
Initial value | auto |
---|---|
Applies to | absolutely positioned elements |
Inherited | no |
Media | visual |
Computed value | auto if specified as auto , otherwise a rectangle with four values, each of which is auto if specified as auto or the computed length otherwise |
Animation type | a rectangle |
Canonical order | the unique non-ambiguous order defined by the formal grammar |
Values
<<shape>()>
- A rectangular
<<shape>()>
of the formrect(<top>, <right>, <bottom>, <left>)
orrect(<top> <right> <bottom> <left>)
(which is a more backwards-compatible syntax). The<top>
and<bottom>
values specify offsets from the inside top border edge of the box, while<right>
and<left>
specify offsets from the inside left border edge of the box — that is, the extent of the padding box. - The
<top>
,<right>
,<bottom>
, and<left>
values may be either a<length>
orauto
. If any side's value isauto
, the element is clipped to that side's inside border edge. auto
- The element does not clip (default value). Note that this is distinct from
rect(auto, auto, auto, auto)
, which does clip to the inside border edges of the element.
Formal syntax
<shape> | autowhere
<shape> = rect(<top>, <right>, <bottom>, <left>)
Examples
CSS
.dotted-border { border: dotted; position: relative; width: 536px; height: 350px; } #top-left, #middle, #bottom-right { position: absolute; top: 0px; } #top-left { left: 360px; clip: rect(0px, 175px, 113px, 0px); } #middle { left: 280px; clip: rect(119px, 255px, 229px, 80px); /* standard syntax, unsupported by Internet Explorer 4-7 */ } #bottom-right { left: 200px; clip: rect(235px 335px 345px 160px); /* non-standard syntax, but supported by all major browsers*/ }
HTML
<p class="dotted-border"> <img src="https://developer.mozilla.org/@api/deki/files/3613/=hut.jpg" title="Original graphic"> <img id="top-left" src="https://developer.mozilla.org/@api/deki/files/3613/=hut.jpg" title="Graphic clipped to upper left"> <img id="middle" src="https://developer.mozilla.org/@api/deki/files/3613/=hut.jpg" title="Graphic clipped towards middle"> <img id="bottom-right" src="https://developer.mozilla.org/@api/deki/files/3613/=hut.jpg" title="Graphic clipped to bottom right"> </p>
Result
Specifications
Specification | Status | Comment |
---|---|---|
CSS Masking Module Level 1 The definition of 'clip' in that specification. |
Candidate Recommendation | Deprecates clip property, suggests clip-path as replacement. |
CSS Transitions The definition of 'clip' in that specification. |
Working Draft | Defines clip as animatable. |
CSS Level 2 (Revision 1) The definition of 'clip' in that specification. |
Recommendation | Initial definition. |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
clip | Chrome Full support 1 | Edge Full support 12 | Firefox Full support 1 | IE
Full support
4
| Opera Full support 7 | Safari
Full support
1
| WebView Android Full support 37 | Chrome Android Full support 18 | Firefox Android Full support 4 | Opera Android ? | Safari iOS
Full support
1
| Samsung Internet Android ? |
Legend
- Full support
- Full support
- Compatibility unknown
- Compatibility unknown
- Deprecated. Not for use in new websites.
- Deprecated. Not for use in new websites.
- See implementation notes.
- See implementation notes.
See also
- This property is deprecated. Use
clip-path
instead. - Related CSS properties:
text-overflow
,white-space
,overflow-x
,overflow-y
,overflow
,display
,position