background-size

Définit la taille de l’image d’arrière-plan : couvrir tout l’élément, tenir entièrement dedans, ou des dimensions précises.

Valeur initiale
auto auto
Héritée
Non
Animable
oui, en tant que longueur ou pourcentage
S’applique à
tous les éléments
JavaScript
element.style.backgroundSize = "cover"
Sur cette page

Exemple

#
CSS
.card-cover {
  aspect-ratio: 16 / 9;
  background: url("/img/course.webp") center / cover no-repeat;
}
Aperçu

Définition et utilisation

#

La propriété background-size décide de la taille de l’image d’arrière-plan. Les deux valeurs les plus importantes sont cover et contain, qui conservent toutes deux les proportions de l’image.

cover agrandit l’image pour qu’elle couvre tout l’élément, quitte à en rogner une partie. contain ajuste l’image pour qu’elle tienne entièrement, quitte à laisser des bandes vides.

Vous pouvez aussi indiquer directement la largeur et la hauteur, en pixels ou en pourcentages. La valeur auto pour l’une des dimensions conserve les proportions.

Syntaxe

#
Syntaxe
background-size: auto | cover | contain | <largeur> <hauteur>?;

Valeurs

#
  • auto

    La taille naturelle de l’image. Une grande photo dépasse de l’élément.
  • cover

    L’image couvre tout l’arrière-plan, les bords peuvent être rognés.
  • contain

    L’image est entièrement visible, des bandes vides peuvent rester sur les côtés.
  • 120px auto

    dimensions

    Largeur de 120px, hauteur proportionnelle.
  • 50% 100%

    pourcentages

    Dimensions relatives à l’élément, les proportions peuvent être déformées.

Valeurs en pratique

#

auto

La taille naturelle de l’image. Une grande photo dépasse de l’élément.
.demo { background-size: auto; }

cover

L’image couvre tout l’arrière-plan, les bords peuvent être rognés.
.demo { background-size: cover; }

contain

L’image est entièrement visible, des bandes vides peuvent rester sur les côtés.
.demo { background-size: contain; }

120px auto

Largeur de 120px, hauteur proportionnelle.
.demo { background-size: 120px auto; }

50% 100%

Dimensions relatives à l’élément, les proportions peuvent être déformées.
.demo { background-size: 50% 100%; }

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

#
  • Pour les couvertures de cartes et les bannières, cover avec background-position: center convient presque toujours.
  • Dans la propriété raccourcie background, la taille se place après la position et une barre oblique : center / cover.

Entrées associées

#

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