CSS background-repeat : répéter, espacer ou ajuster une image de fond

En CSS, background-repeat détermine comment une image de fond se répète. Utilisez no-repeat pour une seule copie, repeat-x pour une répétition horizontale et repeat-y pour une répétition verticale. Pour afficher des motifs entiers, space les espace et round les redimensionne.

Choisir la valeur et le sens de répétition

Valeur Effet
repeat Répète sur les deux axes. C’est la valeur initiale. Les motifs de bord peuvent être coupés.
repeat-x / repeat-y Répète horizontalement ou verticalement, respectivement.
no-repeat Peint une seule copie.
space Place des copies entières et répartit l’espace restant entre elles.
round Redimensionne les motifs pour faire tenir un nombre entier de copies.

Avec deux valeurs, la première s’applique à l’horizontale et la seconde à la verticale. repeat no-repeat équivaut à repeat-x. space no-repeat répartit les espaces horizontalement et affiche une seule rangée.

Spécification W3C sur la répétition des images de fond

Comparer quatre valeurs avec le même motif

Enregistrez le code complet en UTF-8 dans background-repeat-example.html, puis ouvrez-le dans le navigateur. Chaque boîte de 220×120px utilise un motif de 80×40px créé avec un dégradé CSS.

<!doctype html>
<html lang="fr">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Comparer quatre valeurs avec le même motif</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 laisse un motif en haut à gauche. repeat coupe le dernier motif au bord droit. space laisse apparaître la couleur de fond entre les colonnes et round rétrécit les motifs. Changez seulement la répétition et gardez les mêmes dimensions pour comparer.

Le même motif de fond affiché une fois, répété avec un bord coupé, espacé en deux colonnes et redimensionné en trois

Différence entre space et round

Avec space, deux motifs de 80px touchent les bords horizontaux et laissent un intervalle de 60px. Si moins de deux motifs tiennent sur un axe, background-position y place la copie unique. Essayez une largeur de 140px et right top pour l’aligner à droite.

Avec round, 220 ÷ 80 donne 2,75, arrondi à trois copies de 73,33px environ. Trois motifs de 40px tiennent déjà en hauteur. Des ajustements différents sur les deux axes peuvent modifier les proportions de l’image.

Calcul de la taille avec round dans la spécification W3C

Régler plusieurs calques de fond

Si plusieurs images de fond sont séparées par des virgules, la première se trouve au-dessus. Donnez les valeurs de background-repeat dans le même ordre.

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

Le code peint le petit cercle une fois et répète le motif diagonal placé dessous. Une seule valeur de répétition est réutilisée sur tous les calques. Séparez les valeurs si les calques doivent se comporter différemment.

Quand le fond se répète de façon inattendue

Si le sens est correct mais que le nombre de motifs surprend, contrôlez background-size et la largeur de la boîte dans les outils de développement. Avec une taille comme cover, l’image peut occuper toute la zone visible.

Un raccourci background appliqué plus tard peut rétablir repeat lorsque la répétition est omise. Indiquez no-repeat ou la valeur voulue dans le raccourci, ou écrivez background-repeat après celui-ci.