background-repeat

Détermine si et comment l’image d’arrière-plan se répète pour remplir l’élément.

Valeur initiale
repeat
Héritée
Non
Animable
non
S’applique à
tous les éléments
JavaScript
element.style.backgroundRepeat = "no-repeat"
Sur cette page

Exemple

#
CSS
.notebook {
  background-image: linear-gradient(transparent 27px, rgba(167, 139, 250, 0.25) 28px);
  background-size: 100% 28px;
  background-repeat: repeat-y;
  line-height: 28px;
}
Aperçu

Définition et utilisation

#

Par défaut, une image d’arrière-plan plus petite que l’élément se répète dans les deux directions comme des carreaux. La propriété background-repeat permet de le désactiver (no-repeat) ou de limiter la répétition à un axe (repeat-x, repeat-y).

Les valeurs space et round répètent l’image sans couper le dernier carreau : space ajoute des espaces entre les copies, et round met légèrement l’image à l’échelle pour qu’un nombre entier de copies tienne.

Pour les photos d’arrière-plan, on règle presque toujours no-repeat, et on réserve la répétition aux motifs et aux textures.

Syntaxe

#
Syntaxe
background-repeat: repeat | no-repeat | repeat-x | repeat-y | space | round;

Valeurs

#
  • repeat

    Des carreaux dans les deux directions, les derniers peuvent être coupés.
  • no-repeat

    Une seule copie de l’image.
  • repeat-x

    Répétition uniquement à l’horizontale.
  • space

    Des carreaux entiers avec des espaces égaux entre eux.
  • round

    Des carreaux légèrement mis à l’échelle pour qu’un nombre entier tienne.

Valeurs en pratique

#

repeat

Des carreaux dans les deux directions, les derniers peuvent être coupés.
.demo { background-repeat: repeat; }

no-repeat

Une seule copie de l’image.
.demo { background-repeat: no-repeat; }

repeat-x

Répétition uniquement à l’horizontale.
.demo { background-repeat: repeat-x; }

space

Des carreaux entiers avec des espaces égaux entre eux.
.demo { background-repeat: space; }

round

Des carreaux légèrement mis à l’échelle pour qu’un nombre entier tienne.
.demo { background-repeat: round; }

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Les dégradés répétés (repeating-linear-gradient) donnent des motifs rayés sans aucun fichier image.
  • Pour les photos, réglez no-repeat, sinon vous verrez des copies de l’image sur les grands écrans.

Entrées associées

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.