Propriété CSSEffets

object-fit

Détermine comment une image ou une vidéo remplit une boîte aux proportions différentes.

Valeur initiale
fill
Héritée
Non
Animable
non
S’applique à
éléments remplacés, par ex. img, video, iframe
JavaScript
element.style.objectFit = "cover"
Sur cette page

Exemple

#
CSS
.avatar {
  width: 64px;
  height: 64px;
  border-radius: 50%;
  object-fit: cover;
}
Aperçu

Définition et utilisation

#

La propriété object-fit concerne les éléments remplacés, comme <img> et <video>. Quand vous leur donnez des dimensions aux proportions différentes de celles du fichier, l’image est par défaut étirée et déformée (fill).

cover remplit toute la boîte en rognant l’excédent, tandis que contain fait tenir toute l’image en laissant des bandes vides. Ce sont les équivalents de background-size: cover et contain, mais pour de vraies images en HTML.

Vous choisissez la partie rognée avec la propriété object-position. Par défaut, l’image est centrée.

Syntaxe

#
Syntaxe
object-fit: fill | contain | cover | none | scale-down;

Valeurs

#
  • fill

    L’image est étirée à la boîte, les proportions sont déformées.
  • cover

    La boîte est remplie, les bords de l’image sont rognés.
  • contain

    Toute l’image est visible, avec des bandes vides au-dessus et en dessous.
  • none

    L’image à sa taille naturelle, rognée à la boîte.
  • scale-down

    La plus petite des options none et contain.

Valeurs en pratique

#

fill

L’image est étirée à la boîte, les proportions sont déformées.
.demo { object-fit: fill; }

cover

La boîte est remplie, les bords de l’image sont rognés.
.demo { object-fit: cover; }

contain

Toute l’image est visible, avec des bandes vides au-dessus et en dessous.
.demo { object-fit: contain; }

none

L’image à sa taille naturelle, rognée à la boîte.
.demo { object-fit: none; }

scale-down

La plus petite des options none et contain.
.demo { object-fit: scale-down; }

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 miniatures dans une grille paraissent uniformes grâce à une boîte fixe (par ex. aspect-ratio: 1) et object-fit: cover.
  • Pour les logos, contain est préférable, afin qu’aucune partie du logo ne soit coupée.

Entrées associées

#

Pratiquer dans les leçons

#

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