Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

background-repeat: ripetere, distanziare o ridimensionare l’immagine

Controlla separatamente gli assi e distingui gli spazi tra tasselli dal ridimensionamento dei tasselli.

Versione: CSS Modules

Sintassi

background-repeat: space no-repeat;

background-repeat descrive come si ripete ciascuna immagine di sfondo dopo dimensionamento e posizionamento. Il valore iniziale repeat ripete in entrambe le direzioni. Con due parole chiave, la prima controlla l’asse orizzontale e la seconda quello verticale. repeat-x significa repeat no-repeat, mentre repeat-y significa no-repeat repeat. no-repeat disegna una sola copia su quell’asse; non ridimensiona l’elemento e non impedisce il ritaglio. Per più immagini, gli stili separati da virgole seguono l’ordine dei livelli; un elenco più breve si ripete.

repeat riempie l’area di disegno e può lasciare tasselli parziali ai bordi. space inserisce quante più copie intere possibile nell’area di posizionamento, mette la prima e l’ultima contro i bordi e distribuisce gli spazi. Ignora background-position su quell’asse quando entrano almeno due copie; altrimenti una singola copia usa quella posizione. round cambia invece la dimensione del tassello per far entrare un numero intero di copie. Interagisce con background-size, compresa la dimensione auto e il rapporto d’aspetto, anziché aggiungere semplicemente spazi.

L’esempio usa un tassello rosso e blu di 50×20px in box larghi 120px. repeat no-repeat lascia l’ultimo tassello parzialmente visibile. space no-repeat disegna due copie invariate con uno spazio bianco di 20px. round no-repeat crea due tasselli larghi 60px, ciascuno con metà rossa e blu di 30px. Un tassello no-repeat centrato inizia a 35px. In un box più stretto di 70px, space contiene una sola copia e rispetta center, iniziandola a 10px. La console stampa gli stili calcolati; una vera riga di pixel PNG verifica ogni segmento di colore e ogni spazio.

Esempi

const cases=[['repeat no-repeat',120,'left top'],['space no-repeat',120,'center top'],['round no-repeat',120,'left top'],['no-repeat',120,'center top'],['space no-repeat',70,'center top']];
cases.forEach(([repeat,width,position],i)=>{
  const box=document.createElement('div');box.id='repeat-'+i;
  box.style.cssText='position:absolute;left:0;height:30px;background-image:linear-gradient(to right,red 50%,blue 50%);background-size:50px 20px';
  box.style.top=(i*40)+'px';box.style.width=width+'px';box.style.backgroundRepeat=repeat;box.style.backgroundPosition=position;document.body.append(box);
  console.log(i+': '+getComputedStyle(box).backgroundRepeat+'; width='+box.offsetWidth);
});

Risultato

0: repeat-x; width=120
1: space no-repeat; width=120
2: round no-repeat; width=120
3: no-repeat; width=120
4: space no-repeat; width=70

Eseguito in Chromium 157.0.8103.51 con tasselli a gradiente dai bordi netti e righe esatte di pixel al rapporto 1. Entrambe le dimensioni di background-size sono fisse; l’adattamento automatico delle proporzioni con round e la sovrapposizione di livelli non sono quindi dichiarati come casi eseguiti.

Fonti