CSSのbackground-repeatで背景画像の繰り返しを調整する方法

CSSの background-repeat は背景画像の繰り返し方を指定します。一度だけ表示するなら no-repeat、横だけなら repeat-x、縦だけなら repeat-y を使います。画像の端を切らずに並べるには、間隔を空ける space と、サイズを変える round を比較します。

繰り返しの値と方向を選ぶ

値 動作
repeat 横と縦の両方に繰り返します。初期値で、端の画像は切れる場合があります。
repeat-x / repeat-y 横方向だけ、または縦方向だけに繰り返します。
no-repeat 一度だけ表示します。
space 画像を切らずに入るだけ置き、余りを間隔として配分します。
round 整数個が収まるようにサイズを調整します。

値を二つ書く場合、最初が横方向、次が縦方向です。repeat no-repeat は repeat-x と同じです。space no-repeat では横の間隔を調整し、縦は1段だけ表示します。

W3CのCSS仕様における背景画像の繰り返し

同じタイルで4つの値を比較する

以下のコード全体をUTF-8で background-repeat-example.html として保存して、ブラウザーで開きます。各ボックスは220×120pxで、CSSグラデーションで作った80×40pxのタイルを使います。

<!doctype html>
<html lang="ja">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>同じタイルで4つの値を比較する</title>
  <style>
    .tile {
      width: 220px;
      max-width: 100%;
      height: 120px;
      background-color: #f7f9fc;
      background-image: linear-gradient(125deg, #254aa5 48%, #9ce5cc 48% 75%, #dbeafe 75%);
      background-size: 80px 40px;
      background-position: left top;
    }
    .single { background-repeat: no-repeat; }
    .repeat { background-repeat: repeat; }
    .space { background-repeat: space; }
    .round { background-repeat: round; }
  </style>
</head>
<body>
  <p>no-repeat</p>
  <div class="tile single"></div>
  <p>repeat</p>
  <div class="tile repeat"></div>
  <p>space</p>
  <div class="tile space"></div>
  <p>round</p>
  <div class="tile round"></div>
</body>
</html>

no-repeat では左上に一つだけ表示されます。repeat では右端のタイルが切れ、space では列の間から背景色が見えます。round ではタイルが少し狭くなります。比較するときは繰り返しの値だけを変えてください。

同じ背景タイルを一つだけ表示する場合、端で切って繰り返す場合、間隔を空けて二列にする場合、幅を縮めて三列にする場合の比較

spaceとroundの違い

space では幅80pxのタイル二つが左右の端に付き、間に60pxの空きができます。ある軸に二つ入らない場合は一つだけ置かれ、位置はその軸の background-position に従います。幅を140px、位置を right top にすると右端に寄ります。

round では220 ÷ 80の2.75を四捨五入して三つ並べます。一つの幅は約73.33pxです。縦は40pxが三つ入るため変わりません。縦と横の調整量が異なると、画像の縦横比が変わることがあります。

W3C仕様のroundによるサイズ計算

複数の背景レイヤーを指定する

背景画像をカンマ区切りで指定すると、一つ目の画像が最前面になります。background-repeat の値も同じ順序で書きます。

.card {
  background-image:
    radial-gradient(circle, #b45309 40%, transparent 42%),
    linear-gradient(135deg, #eff6ff 50%, #dbeafe 50%);
  background-size: 32px 32px, 64px 64px;
  background-repeat: no-repeat, repeat;
}

このコードは手前の小さな円を一度だけ描き、下の斜め模様を繰り返します。値が一つならすべてのレイヤーに使われます。レイヤーごとに異なる動きが必要なら別の値を指定します。

背景が想定どおりに繰り返されないとき

方向が合っていて枚数だけが想定と違う場合は、開発者ツールで background-size とボックス幅を確認します。cover のような値では画像が表示領域全体を覆い、繰り返しが見えない場合があります。

後から適用される background 一括指定で繰り返しを省略すると、repeat に戻ることがあります。一括指定に no-repeat などを含めるか、その後で background-repeat を指定します。