Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

object-fit — ajuster le contenu à la boîte d’un élément

object-fit détermine comment le contenu d’un élément remplacé s’ajuste à sa boîte de contenu. La propriété permet de préserver les proportions, de recadrer une image ou de l’étirer sans modifier les dimensions de la boîte de l’élément.

Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntaxe

object-fit: fill | none | [contain | cover] || scale-down;

object-fit contrôle la façon dont le contenu d’un élément remplacé, comme une image img, s’ajuste à sa boîte de contenu. La propriété ne définit pas les dimensions de cette boîte : dans l’exemple, ce sont width et height qui le font. Sa valeur initiale est fill ; elle n’est pas héritée et son animation est discrète.

fill remplit la boîte et peut déformer les proportions. contain préserve les proportions et fait tenir tout le contenu, en laissant éventuellement des bandes vides. cover préserve les proportions et couvre toute la boîte, en recadrant le contenu si nécessaire. none ne redimensionne pas le contenu pour l’adapter : il utilise l’algorithme de dimensionnement par défaut, qui donne généralement les dimensions naturelles. scale-down choisit le plus petit résultat entre none et contain.

Les zones vides affichent l’arrière-plan de l’élément, et le contenu qui dépasse de la boîte est rogné. object-position contrôle le placement. Cette propriété ajuste le contenu de l’élément, et non une image d’arrière-plan contrôlée par background-size.

La grammaire de niveau 4 permet aussi de combiner scale-down avec contain ou cover ; scale-down utilisé seul signifie contain scale-down. La variante cover scale-down choisit le plus petit résultat entre none et cover, et peut donc laisser de l’espace vide. Le fait qu’une combinaison figure dans la spécification ne garantit pas sa prise en charge par les navigateurs ; ces combinaisons doivent être vérifiées séparément.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>object-fit: contain</title>
<style>
  img {
    display: block;
    width: 120px;
    height: 120px;
    object-fit: contain;
    object-position: center;
    background: #ddd;
  }
</style>
<img alt="Red rectangle" src="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='200' height='100' viewBox='0 0 200 100'%3E%3Cpath fill='red' d='M0 0H200V100H0Z'/%3E%3C/svg%3E">

Résultat

A 120 × 120 CSS-pixel image box containing a centered 120 × 60 red rectangle, with 30 CSS-pixel gray bands above and below.

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources