Summary
The
background-clip
CSS property specifies whether an element's background, either the color or image, extends underneath its border.If no background image or color is set, this property will only have a visual effect when the border has transparent regions or partially opaque regions (due to
border-style
or border-image); otherwise the border covers up the difference.| Initial value | border-box |
|---|---|
| Applies to | all elements. It also applies to
::first-letter
and ::first-line. |
| Inherited | no |
| Media | visual |
| Computed value | as specified |
| Animation type | discrete |
| Canonical order | the unique non-ambiguous order defined by the formal grammar |
Syntax
/* Keyword values */
background-clip: border-box;
background-clip: padding-box;
background-clip: content-box;
background-clip: text;
/* Global values */
background-clip: inherit;
background-clip: initial;
background-clip: unset;Values
border-box- The background extends to the outside edge of the border (but underneath the border in z-ordering).
padding-box- No background is drawn below the border (background extends to the outside edge of the padding).
content-box- The background is painted within (clipped to) the content box.
text- The background is painted within (clipped to) the foreground text.
Formal syntax
<box>#
Examples
HTML content
<p class="border-box">The yellow background extends behind the border.</p>
<p class="padding-box">The yellow background extends to the inside edge of the border.</p>
<p class="content-box">The yellow background extends only to the edge of the content box.</p>CSS content
p {
border: 10px navy;
border-style: dotted double;
margin: 1em;
padding: 2em;
background: #F8D575;
}
.border-box { background-clip: border-box; }
.padding-box { background-clip: padding-box; }
.content-box { background-clip: content-box; }Output
The yellow background extends behind the border.
The yellow background extends to the inside edge of the border.
The yellow background extends only to the edge of the content box.
Specifications
| Specification | Status | Comment |
|---|---|---|
| CSS Backgrounds and Borders Module Level 3 The definition of 'background-clip' in that specification. |
CRCandidate Recommendation | Initial definition |
| CSS Backgrounds and Borders Module Level 4 The definition of 'background-clip' in that specification. |
EDEditor's Draft | Add
text
value |
Browser compatibility
1. Webkit also supports the prefixed version of this property, and in that case, in addition to the current keywords, the alternative synonyms are:
padding,
border, and
content.2. Gecko supported, from version 1.1 to version 1.9.2, which corresponds to Firefox 1.0 to 3.6 included, a different and prefixed syntax:
-moz-background-clip: padding | border.3. In IE 7 and IE 9 of Internet Explorer, it always behaved like
background-clip: padding
if overflow: hidden | auto | scroll4. Support the prefixed version of the property only; according to the
official blog, WebKit does not include text decorations or shadows in the clipping.
5. In Firefox 48, it was not activated by default and its support could be activated by setting
layout.css.background-clip-text.enabled
pref to true.