Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

Immagini e contenuti multimediali in CSS

CSS controlla la visualizzazione di immagini e contenuti multimediali: dalle immagini di sfondo e dai gradienti all’adattamento del contenuto degli elementi img e video. È importante distinguere tra le dimensioni dell’elemento, quelle del suo contenuto e lo sfondo decorativo.

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

Sintassi

background-image: <image> | none;
background-size: auto | contain | cover | <length-percentage [0,∞]>{1,2};
object-fit: fill | contain | cover | none | scale-down;
/* object-fit: none uses the default sizing algorithm with no specified size and the element’s content-box size as the default object size. If the object has a natural aspect ratio but neither a natural width nor a natural height, the algorithm applies a contain constraint to fit the object within the content box. */
/* object-fit: scale-down uses whichever of none and contain produces the smaller object size. */
object-position: <position>;

In CSS, “immagini e contenuti multimediali” è un ambito tematico, non una parola chiave né una singola proprietà. Il tipo <image> comprende, tra le altre cose, le immagini indicate con url() e i gradienti come linear-gradient(). Un gradiente è un’immagine generata da CSS, non un colore. CSS controlla la presentazione dei contenuti multimediali, ma non sostituisce i meccanismi HTML per selezionare le sorgenti e controllare la riproduzione.

Un’immagine impostata con background-image viene disegnata come sfondo dell’elemento e non gli assegna dimensioni. Le proprietà background-size, background-position e background-repeat ne controllano rispettivamente il ridimensionamento, la posizione e la ripetizione. Considera gli sfondi come decorazioni; le informazioni importanti per chi legge dovrebbero essere disponibili anche nel contenuto o tramite un’adeguata alternativa testuale.

Gli elementi sostituiti, come img e video, hanno contenuti il cui rendering interno non segue il normale layout CSS dei discendenti. width e height determinano le dimensioni del riquadro, mentre object-fit dimensiona il contenuto in base all’area di contenuto dell’elemento. Se l’oggetto ha proporzioni naturali, sia contain sia cover le mantengono: contain usa le dimensioni massime che rientrano nell’area di contenuto, mentre cover usa le dimensioni minime con larghezza e altezza almeno pari a quelle di tale area. Se l’oggetto non ha proporzioni naturali, entrambi i valori gli assegnano la larghezza e l’altezza dell’area di contenuto dell’elemento. fill può deformare le proporzioni. object-position stabilisce la posizione del contenuto: spostarlo può far sì che una parte del contenuto venga ritagliata con contain o che una parte dell’area di contenuto rimanga scoperta con cover. Queste proprietà non ridimensionano le immagini di sfondo.

L’esempio crea un’immagine senza scaricare un file: due interruzioni di colore a 50% producono un confine netto. La sintassi mostrata è una selezione abbreviata di dichiarazioni per un singolo livello di sfondo, non la grammatica completa. I documenti CSSWG sono bozze redazionali; la presenza di una funzionalità in una bozza non dimostra che sia supportata dai browser. L’esempio richiede una verifica separata nell’ambiente di destinazione.

Esempi

<!doctype html>
<meta charset="utf-8">
<title>CSS image</title>
<style>
  .sample {
    width: 200px;
    height: 100px;
    background-color: white;
    background-image: linear-gradient(to right, red 50%, blue 50%);
    background-size: 100% 100%;
    background-repeat: no-repeat;
  }
</style>
<div class="sample" role="img" aria-label="Red left half and blue right half"></div>

Risultato

A 200 × 100 CSS-pixel rectangle: the left 100 pixels are red and the right 100 pixels are blue, with a sharp vertical boundary.

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