background-repeat プロパティ
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。
background-repeat は CSS の一括指定プロパティで、背景画像をどのように反復するかを設定します。背景画像は水平軸方向と垂直軸方向に繰り返したり、まったく反復しないようにしたりすることができます。
試してみましょう
background-repeat: repeat-x;
background-repeat: repeat;
background-repeat: space;
background-repeat: round;
background-repeat: no-repeat;
background-repeat: space repeat;
<section id="default-example">
<div id="example-element"></div>
</section>
#example-element {
background: #cccccc url("/shared-assets/images/examples/moon.jpg") center /
120px;
min-width: 100%;
min-height: 100%;
}
構成要素のプロパティ
このプロパティは以下の CSS プロパティの一括指定です。
構文
/* キーワード値 */
background-repeat: repeat;
background-repeat: repeat-x;
background-repeat: repeat-y;
background-repeat: space;
background-repeat: round;
background-repeat: no-repeat;
/* 値 2 つの構文: 水平方向 | 垂直方向 */
background-repeat: repeat space;
background-repeat: repeat repeat;
background-repeat: round space;
background-repeat: no-repeat round;
/* グローバル値 */
background-repeat: inherit;
background-repeat: initial;
background-repeat: revert;
background-repeat: revert-layer;
background-repeat: unset;
値
このプロパティには、2 つの <repeat-style> キーワードをカンマで区切ったリスト、または 2 つの値の短縮形となる 1 つのキーワードを指定します。最初の値は水平方向の反復方法で、2 つ目の値は垂直方向の動作です。repeat-x または repeat-y 以外の値を 1 つだけ指定した場合、その値は両方向に適用されます。以下の値が指定できます。
repeat-
デフォルト値です。画像は、背景画像の描画領域全体を覆うのに必要な回数だけ反復されます。描画領域の寸法が背景画像の寸法の倍数でない場合は、端の画像が切り取られます。
no-repeat-
画像は反復して描画されません(したがって背景画像描画領域が完全に埋め尽くされるとは限りません)。背景画像の位置は CSS の
background-positionプロパティで定義されます。 space-
画像は、切り取られることなく敷き詰められるだけ反復して表示されます。最初と最後の画像は領域の両端に配置され、余白が画像同士の間に均等に配分されます。
background-positionプロパティは、画像が 1 つだけ切り取られることなく表示できる場合を除き、無視されます。spaceを使用していて背景画像が切り取られるのは、領域幅を超える背景画像が指定された場合のみです。 round-
利用可能な空間が大きくなるにつれ、繰り返される画像は、もう 1 つ追加する余裕ができるまで(隙間なく)引き伸ばされます。これは、
<repeat-style>値の中で唯一、背景画像の歪みにつながる可能性がある値です。これは、背景画像のアスペクト比が背景描画領域のものと異なる場合に発生します。 repeat-x-
repeat no-repeatの短縮形で、背景画像は水平方向にのみ繰り返され、描画領域の幅が背景画像の幅の倍数でない場合は、端の画像が切り取られます。 repeat-y-
no-repeat repeatの短縮形で、背景画像は垂直方向にのみ繰り返され、描画領域の高さが背景画像の高さの倍数でない場合は、端の画像が切り取られます。
<repeat-style> キーワードが 1 つだけ指定された場合、その値は次の 2 値構文の短縮形となります。
| 単一の値 | 同等の 2 つの値 |
|---|---|
repeat-x |
repeat no-repeat |
repeat-y |
no-repeat repeat |
repeat |
repeat repeat |
space |
space space |
round |
round round |
no-repeat |
no-repeat no-repeat |
解説
このプロパティには、2 つの <repeat-style> キーワードをカンマで区切ったリスト、または 2 つの値の短縮形となる 1 つのキーワードを指定します。2 つの値を指定した場合、最初の値が水平方向の反復方法を、2 つ目の値が垂直方向の反復方法を定義します。値を使用して、水平方向のみ、垂直方向のみ、またはどちらにも反復しないようにできます。
デフォルト値は repeat repeat です。この値では、背景画像の内在的な アスペクト比が保たれ、背景描画領域全体を覆うように水平方向と垂直方向の両方に反復されます。端の画像は要素のサイズに合わせて切り取られます。どの端が切り取られるかは、対応する background-position の値によって決まります。反復回数と端の画像が切り取られる量は、背景描画領域のサイズと対応する background-size の値によって決まります。
画像を切り取らずにアスペクト比を保つため、反復画像を均等な間隔で配置することもできます。space 値を使用すると、背景描画領域と画像のアスペクト比が異なる場合や、背景描画領域のいずれかの方向のサイズが背景サイズの倍数でない場合、背景画像で覆われない領域が生じます。
また、反復画像を引き伸ばして、切り取らずに領域全体を覆うこともできます。round では、背景画像と描画領域のアスペクト比が異なる場合、追加の画像を配置できる余地ができるまで、反復画像が利用可能な空間を埋めるように引き伸ばされます。たとえば、100px × 100px の背景画像を 1099px × 750px の背景描画領域に配置すると、水平方向に 10 回、垂直方向に 7 回、合計 70 回反復されます。それぞれの画像は両方向に引き伸ばされて 109.9px × 105px となり、アスペクト比が変わって画像が歪む可能性があります。描画領域の幅が 1px 増えて 1100px になると、水平方向に 11 枚目の画像を配置でき、合計 77 回反復されます。この場合、各画像は幅 100px、高さ 105px で描画され、垂直方向にのみ引き伸ばされます。
公式定義
| 初期値 | repeat |
|---|---|
| 適用対象 | すべての要素。 ::first-letterおよび::first-line にも適用されます。 |
| 継承 | なし |
| 計算値 | 1 つの方向につき 2 つのキーワードで構成される項目のリスト |
| アニメーションの種類 | 離散値 |
形式文法
background-repeat =
<repeat-style>#
<repeat-style> =
repeat-x |
repeat-y |
repeat-block |
repeat-inline |
<repetition>{1,2}
<repetition> =
repeat |
space |
round |
no-repeat
例
>background-repeat の設定
HTML
<ol>
<li>
no-repeat
<div class="one"></div>
</li>
<li>
repeat
<div class="two"></div>
</li>
<li>
repeat-x
<div class="three"></div>
</li>
<li>
repeat-y
<div class="four"></div>
</li>
<li>
space
<div class="five"></div>
</li>
<li>
round
<div class="six"></div>
</li>
<li>
repeat-x, repeat-y (複数の画像)
<div class="seven"></div>
</li>
</ol>
CSS
/* 例のすべての div で共通 */
ol,
li {
margin: 0;
padding: 0;
}
li {
margin-bottom: 12px;
}
div {
background-image: url("star-solid.gif");
width: 160px;
height: 70px;
}
/* 背景の繰り返し */
.one {
background-repeat: no-repeat;
}
.two {
background-repeat: repeat;
}
.three {
background-repeat: repeat-x;
}
.four {
background-repeat: repeat-y;
}
.five {
background-repeat: space;
}
.six {
background-repeat: round;
}
/* 複数の画像 */
.seven {
background-image:
url("star-solid.gif"), url("/shared-assets/images/examples/favicon32.png");
background-repeat: repeat-x, repeat-y;
height: 144px;
}
結果
この例では、リストの各要素に background-repeat の様々な値が対応付けられています。
仕様書
| 仕様書 |
|---|
| CSS Backgrounds and Borders Module Level 3> # background-repeat> |