background-clip

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

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

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

注: ルート要素が HTML 要素である文書の場合、ルート要素上の background-image の計算値が none であり、その background-colortransparent であると、ユーザーエージェントは代わりに、 background プロパティの計算値をその要素の HTML の <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
背景を前景のテキストの中に (切り取って) 表示します。

公式定義

初期値border-box
適用対象すべての要素。 ::first-letter and ::first-line にも適用されます。
継承なし
計算値指定値
アニメーションの種類個別

形式文法

<box>#

where
<box> = border-box | padding-box | content-box

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);
}

結果

仕様書

仕様書 状態 備考
CSS Backgrounds and Borders Module Level 3
background-clip の定義
勧告候補 初回定義
CSS Backgrounds and Borders Module Level 4
background-clip の定義
編集者草案 text の値を追加。

ブラウザーの互換性

BCD tables only load in the browser

関連情報