Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

background-size — dimensionare le immagini di sfondo

La proprietà background-size controlla le dimensioni delle immagini di sfondo, non quelle dell’elemento. Puoi specificare le dimensioni, usare auto oppure adattare un’immagine con contain o cover.

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

Sintassi

background-size: <bg-size>#;
<bg-size> = [ <length-percentage [0,∞]> | auto ]{1,2} | cover | contain

background-size imposta le dimensioni di ogni immagine di sfondo, non quelle dell’elemento. Il valore iniziale è auto auto e la proprietà non è ereditata.

Nella sintassi per larghezza e altezza, il primo valore specifica la larghezza e il secondo l’altezza. Se in questa sintassi si indica solo la larghezza, l’altezza assume il valore auto. Lunghezze e percentuali devono essere non negative. Le percentuali si riferiscono alle dimensioni corrispondenti dell’area di posizionamento dello sfondo, di solito determinata da background-origin. auto usa le proporzioni e le dimensioni naturali dell’immagine, se disponibili; non indica sempre le dimensioni del file originale.

contain e cover sono modalità di dimensionamento autonome che determinano entrambe le dimensioni dell’immagine. contain mantiene le proporzioni naturali, se presenti, e fa rientrare l’intera immagine nell’area. cover le mantiene e copre tutta l’area; una parte dell’immagine può essere ritagliata. 100% 100% imposta le due dimensioni in modo indipendente e può distorcere l’immagine.

Le virgole separano le dimensioni dei livelli successivi di background-image; un elenco troppo corto viene ripetuto e i valori in eccesso vengono ignorati. La ripetizione è controllata separatamente da background-repeat. Nella forma abbreviata background, la dimensione segue la posizione e /, per esempio background: none center / cover no-repeat.

Esempi

<!doctype html>
<meta charset="utf-8">
<title>background-size</title>
<style>
  .sample {
    width: 200px;
    height: 120px;
    background-color: #ddd;
    background-image: linear-gradient(to right, #06c 50%, #fc0 50%);
    background-size: 50% 50%;
    background-position: center;
    background-repeat: no-repeat;
  }
</style>
<div class="sample"></div>

Risultato

A 200 × 120 CSS-pixel gray rectangle contains a centered 100 × 60 CSS-pixel image: its left half is blue and its right half is yellow.

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