Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

object-fit — adattare il contenuto al riquadro di un elemento

object-fit determina come il contenuto di un elemento sostituito si adatta al suo riquadro del contenuto. Permette di mantenere le proporzioni, ritagliare un’immagine o allungarla senza cambiare le dimensioni del riquadro dell’elemento.

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

Sintassi

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

object-fit controlla come il contenuto di un elemento sostituito, per esempio un’immagine img, si adatta al suo riquadro del contenuto. La proprietà non stabilisce le dimensioni del riquadro: nell’esempio, se ne occupano width e height. Il valore iniziale è fill; non è ereditata e la sua animazione è discreta.

fill riempie il riquadro e può deformare le proporzioni. contain mantiene le proporzioni e fa rientrare tutto il contenuto, lasciando eventualmente delle bande vuote. cover mantiene le proporzioni e copre l’intero riquadro, ritagliando il contenuto quando necessario. none non ridimensiona il contenuto per adattarlo: usa l’algoritmo di dimensionamento predefinito, che in genere produce le dimensioni naturali. scale-down sceglie il risultato più piccolo tra none e contain.

Le aree vuote mostrano lo sfondo dell’elemento e il contenuto che supera il riquadro viene ritagliato. object-position ne controlla il posizionamento. Questa proprietà adatta il contenuto dell’elemento, non un’immagine di sfondo controllata da background-size.

La grammatica di livello 4 consente anche di combinare scale-down con contain o cover; scale-down da solo significa contain scale-down. La variante cover scale-down sceglie il risultato più piccolo tra none e cover, quindi può lasciare spazio vuoto. La presenza di una combinazione nella specifica non ne dimostra il supporto nei browser: le combinazioni vanno verificate separatamente.

Esempi

<!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">

Risultato

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti