background-origin
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
background-origin
は CSS のプロパティで、背景配置領域を境界の開始位置、境界の内部、パディングの内部から設定します。
試してみましょう
background-attachment
が fixed
のときは background-origin
が無視されることに注意してください。
構文
css
/* キーワード値 */
background-origin: border-box;
background-origin: padding-box;
background-origin: content-box;
/* グローバル値 */
background-origin: inherit;
background-origin: initial;
background-origin: revert;
background-origin: revert-layer;
background-origin: unset;
background-origin
プロパティは、以下の一覧にあるキーワード値のうちの一つで指定します。
値
border-box
-
背景は境界ボックスからの相対位置になります。
padding-box
-
背景はパディングボックスからの相対位置になります。
content-box
-
背景はコンテンツボックスからの相対位置になります。
公式定義
初期値 | padding-box |
---|---|
適用対象 | すべての要素。 ::first-letter および::first-line にも適用されます。 |
継承 | なし |
計算値 | 指定通り |
アニメーションの種類 | 反復可能リスト |
形式文法
例
背景画像の原点を設定
css
.example {
border: 10px double;
padding: 10px;
background: url("image.jpg");
background-position: center left;
background-origin: content-box;
}
css
#example2 {
border: 4px solid black;
padding: 10px;
background: url("image.gif");
background-repeat: no-repeat;
background-origin: border-box;
}
css
div {
background-image: url("logo.jpg"), url("mainback.png"); /* 背景に 2 つの画像を適用 */
background-position:
top right,
0px 0px;
background-origin: content-box, padding-box;
}
2 つのグラデーションの使用
この例では、ボックスに太い点線の境界線が付いています。最初のグラデーションでは、 padding-box
を background-origin
として使用しているため、背景は境界線の内側に表示されます。2 つ目のグラデーションは、content-box
を使用しているため、コンテンツの後ろにのみ表示されます。
css
.box {
margin: 10px 0;
color: #fff;
background: linear-gradient(
90deg,
rgb(131 58 180 / 100%) 0%,
rgb(253 29 29 / 60%) 60%,
rgb(252 176 69 / 100%) 100%
),
radial-gradient(circle, rgb(255 255 255 / 100%) 0%, rgb(0 0 0 / 100%) 28%);
border: 20px dashed black;
padding: 20px;
width: 400px;
background-origin: padding-box, content-box;
background-repeat: no-repeat;
}
html
<div class="box">Hello!</div>
仕様書
Specification |
---|
CSS Backgrounds and Borders Module Level 3 # the-background-origin |
ブラウザーの互換性
BCD tables only load in the browser