Please note, this is a STATIC archive of website developer.mozilla.org from 03 Nov 2016, cach3.com does not collect or store any user information, there is no "phishing" involved.

Revision 1133123 of background-clip

  • リビジョンの URL スラグ: Web/CSS/background-clip
  • リビジョンのタイトル: background-clip
  • リビジョンの ID: 1133123
  • 作成日:
  • 作成者: takahashim
  • 現行リビジョン? はい
  • コメント 表記ゆれ修正、ナカグロ削除、コンテントボックス→コンテンツボックス

このリビジョンの内容

{{CSSRef}}

概要

background-clip プロパティは、要素の背景色と背景画像の描画領域を、「ボーダーの裏側まで拡張する(デフォルト)」、「余白の領域までとする」、「コンテンツエリアのみとする」のいずれかに指定します。

{{cssinfo}}

構文

{{csssyntax}}

border-box
背景の描画領域を、ボーダーの外側の端までとします。
padding-box
背景の描画領域を、パディングボックスの外側の端までとします。
content-box
背景の描画領域を、コンテンツボックスの外側の端までとします。
{{訳注("コンテンツボックスとは余白の領域を含まない、要素の内容が表示される領域の事です")}}

以下の例で用いる共通のスタイル

pre {
  border: 10px navy;
  border-style: dotted double;
  background: #F8D575;
}

上記のスタイルを持つ pre 要素に対し、それぞれ別の値の background-clip を指定し、表示結果を以下に示します。

border-box

pre {
  background-clip: border-box;
}

padding-box

pre {
  background-clip: padding-box;
}

content-box

pre {
  background-clip: content-box;
}

※ここでは表示結果の部分のスタイルに、ベンダー接頭辞付きのプロパティを併記してクロスブラウザ表示を実現しています。実際にご使用になる場合はご注意下さい。

仕様

仕様書 策定状況 コメント
CSS Backgrounds and Borders Module Level 3 {{Spec2('CSS3 Backgrounds')}}  

ブラウザ実装状況

{{CompatibilityTable()}}

機能 Chrome Firefox (Gecko) Internet Explorer Opera Safari
基本サポート 1.0 [3] {{CompatGeckoDesktop("2.0")}} [1] 9.0 [2] 10.5 3.0 (522) [3]
content-box 1.0 [3] {{CompatGeckoDesktop("2.0")}} [1] 9.0 [2] {{CompatNo()}} 3.0 (522) [3]
機能 Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
基本サポート {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}}
content-box {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}}

[1] Gecko では バージョン 1.1 から バージョン 1.9.2(Firefox 1.0 から 3.6 に相当)でもこれらが実装されていますが、ベンダー接頭辞が必要であり、またその指定値も異なります。
-moz-background-clip: padding | border.

[2] Internet Explorer 7(※前後のバージョンは含まれない)では、 overflow: hidden | auto | scroll が指定されている場合、 background-clip:padding の様な挙動を示します。

[3] 過去のバージョンの Webkit も接頭辞付きの -webkit-background-clip をサポートしていますが、その指定値が異なります。
-webkit-background-clip: padding | border | content | text

[4] Konqueror 3.5.4 は -khtml-background-clip をサポートしています。

関連情報

  • {{cssxref("clip")}}

このリビジョンのソースコード

<div>{{CSSRef}}</div>

<h2 id="Summary" name="Summary">概要</h2>

<p>background-clip プロパティは、<em>要素の背景色と背景画像の描画領域</em>を、「ボーダーの裏側まで拡張する(デフォルト)」、「余白の領域までとする」、「コンテンツエリアのみとする」のいずれかに指定します。</p>

<p>{{cssinfo}}</p>

<h2 id="Syntax" name="Syntax">構文</h2>

<pre class="syntaxbox">
{{csssyntax}}</pre>

<h3 id="Values" name="Values">値</h3>

<dl>
 <dt>border-box</dt>
 <dd>背景の描画領域を、ボーダーの外側の端までとします。</dd>
 <dt>padding-box</dt>
 <dd>背景の描画領域を、パディングボックスの外側の端までとします。</dd>
 <dt>content-box</dt>
 <dd>背景の描画領域を、コンテンツボックスの外側の端までとします。
 <div>{{訳注("コンテンツボックスとは余白の領域を含まない、要素の内容が表示される領域の事です")}}</div>
 </dd>
</dl>

<h2 id="Examples" name="Examples">例</h2>

<h3 id="Basic_style_for_example" name="Basic_style_for_example">以下の例で用いる共通のスタイル</h3>

<pre>
pre {
  border: 10px navy;
  border-style: dotted double;
  background: #F8D575;
}</pre>

<p>上記のスタイルを持つ pre 要素に対し、それぞれ別の値の <code>background-clip</code> を指定し、表示結果を以下に示します。</p>

<h3 id="border-box">border-box</h3>

<pre style="overflow:visible;border:10px navy;border-style:dotted double;background:#F8D575;-webkit-background-clip:border;-moz-background-clip:border-box;background-clip:border-box;">
pre {
  background-clip: border-box;
}</pre>

<h3 id="padding-box">padding-box</h3>

<pre style="overflow:visible;border:10px navy;border-style:dotted double;background:#F8D575;-webkit-background-clip:padding;-moz-background-clip:padding-box;background-clip:padding-box;">
pre {
  background-clip: padding-box;
}</pre>

<h3 id="content-box">content-box</h3>

<pre style="overflow:visible;border:10px navy;border-style:dotted double;background:#F8D575;-webkit-background-clip:content;-moz-background-clip:content-box;background-clip:content-box;">
pre {
  background-clip: content-box;
}</pre>

<p><small>※ここでは表示結果の部分のスタイルに、ベンダー接頭辞付きのプロパティを併記してクロスブラウザ表示を実現しています。実際にご使用になる場合はご注意下さい。</small></p>

<h2 id="仕様">仕様</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">仕様書</th>
   <th scope="col">策定状況</th>
   <th scope="col">コメント</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td><a class="external" href="https://dev.w3.org/csswg/css3-background/#the-background-clip" title="CSS Backgrounds and Borders Module Level 3 - #the-background-clip">CSS Backgrounds and Borders Module Level 3</a></td>
   <td>{{Spec2('CSS3 Backgrounds')}}</td>
   <td>&nbsp;</td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザ実装状況</h2>

<p>{{CompatibilityTable()}}</p>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>機能</th>
   <th>Chrome</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari</th>
  </tr>
  <tr>
   <td>基本サポート</td>
   <td>1.0 [3]</td>
   <td>{{CompatGeckoDesktop("2.0")}} [1]</td>
   <td>9.0 [2]</td>
   <td>10.5</td>
   <td>3.0 (522) [3]</td>
  </tr>
  <tr>
   <td><code>content-box</code></td>
   <td>1.0 [3]</td>
   <td>{{CompatGeckoDesktop("2.0")}} [1]</td>
   <td>9.0 [2]</td>
   <td>{{CompatNo()}}</td>
   <td>3.0 (522) [3]</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>機能</th>
   <th>Android</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>IE Phone</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>基本サポート</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
  </tr>
  <tr>
   <td><code>content-box</code></td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
  </tr>
 </tbody>
</table>
</div>

<p>[1] Gecko では バージョン 1.1 から バージョン 1.9.2(Firefox 1.0 から 3.6 に相当)でもこれらが実装されていますが、ベンダー接頭辞が必要であり、またその指定値も異なります。<br />
 <code>-moz-background-clip: padding | border</code>.</p>

<p>[2] Internet Explorer 7(※前後のバージョンは含まれない)では、 <code>overflow: hidden | auto | scroll</code> が指定されている場合、 <code>background-clip:padding</code> の様な挙動を示します。</p>

<p>[3] 過去のバージョンの Webkit も接頭辞付きの <code>-webkit-background-clip</code> をサポートしていますが、その指定値が異なります。<br />
 <code>-webkit-background-clip: padding | border | content | text</code></p>

<p>[4] Konqueror 3.5.4 は <code> -khtml-background-clip</code> をサポートしています。</p>

<h2 id="See_also" name="See_also">関連情報</h2>

<ul>
 <li>{{cssxref("clip")}}</li>
</ul>
このリビジョンへ戻す