--- title: background-clip slug: Web/CSS/background-clip tags: - CSS - CSS Background - CSS Property - Reference - 'recipe:css-property' translation_of: Web/CSS/background-clip ---

{{CSSRef}}

background-clip は CSS のプロパティで、要素の背景を境界ボックス、パディングボックス、コンテンツボックスのどれまで拡張するかを設定します。

{{EmbedInteractiveExample("pages/css/background-clip.html")}}

要素に {{cssxref("background-image")}} または {{cssxref("background-color")}} がない場合、このプロパティは ({{cssxref("border-style")}} または {{cssxref("border-image")}} によって) 境界に透明な領域や部分的に不透明な領域がある場合のみ視覚効果があります。そうでなければ、境界は異なるマスク方法になります。

注: ルート要素は異なる背景の描画領域を持っているため、その要素に background-clip プロパティが指定されても効果はありません。「特殊要素の背景」を参照してください。

注: ルート要素が HTML 要素である文書の場合、ルート要素上の {{cssxref("background-image")}} の計算値が none であり、その {{cssxref("background-color")}} が transparent であると、ユーザーエージェントは代わりに、 {{cssxref("background")}} プロパティの計算値をその要素の HTML の {{HTMLElement("body")}} の子要素から伝搬させなければなりません。その <body> 要素の background プロパティの使用値はその初期値であり、伝搬された値は、それらがルート要素上で指定されたかのように扱われます。 HTML 文書を作成するときは、 HTML 要素ではなく、 <body> 要素にキャンバスの背景を指定することを推奨します。

構文

/* キーワード値 */
background-clip: border-box;
background-clip: padding-box;
background-clip: content-box;
background-clip: text;

/* グローバル値 */
background-clip: inherit;
background-clip: initial;
background-clip: unset;

値

border-box
背景を境界の外側の辺まで拡張します (但し、境界の下に重ね合わせられます)。
padding-box
背景をパディングの外側の辺まで拡張します。境界の下には背景が描かれません。
content-box
背景をコンテンツボックスの中に (切り取って) 表示します。
text {{experimental_inline}}
背景を前景のテキストの中に (切り取って) 表示します。

公式定義

{{cssinfo}}

形式文法

{{csssyntax}}

例

HTML

<p class="border-box">背景が境界の裏まで拡張されます。</p>
<p class="padding-box">背景が境界の内側の縁まで拡張されます。</p>
<p class="content-box">背景がコンテンツボックスの縁までだけ表示されます。</p>
<p class="text">背景が前景のテキストで切り取られます。</p>

CSS

p {
  border: .8em darkviolet;
  border-style: dotted double;
  margin: 1em 0;
  padding: 1.4em;
  background: linear-gradient(60deg, red, yellow, red, yellow, red);
  font: 900 1.2em sans-serif;
  text-decoration: underline;
}

.border-box { background-clip: border-box; }
.padding-box { background-clip: padding-box; }
.content-box { background-clip: content-box; }

.text {
  background-clip: text;
  -webkit-background-clip: text;
  color: rgba(0,0,0,.2);
}

結果

{{EmbedLiveSample('Examples', 600, 580)}}

仕様書

仕様書 状態 備考
{{SpecName('CSS3 Backgrounds', '#the-background-clip', 'background-clip')}} {{Spec2('CSS3 Backgrounds')}} 初回定義
{{SpecName('CSS4 Backgrounds', '#background-clip', 'background-clip')}} {{Spec2('CSS4 Backgrounds')}} text の値を追加。

ブラウザーの互換性

{{Compat("css.properties.background-clip")}}

関連情報