Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

background-repeat: repetir, espaçar ou redimensionar a imagem

Controle cada eixo separadamente e distinga os intervalos entre mosaicos da alteração do tamanho das cópias.

Versão: CSS Modules

Sintaxe

background-repeat: space no-repeat;

background-repeat descreve como cada imagem de fundo se repete depois de dimensionada e posicionada. O valor inicial repeat repete nas duas direções. Com duas palavras-chave, a primeira controla o eixo horizontal e a segunda o vertical. repeat-x significa repeat no-repeat; repeat-y significa no-repeat repeat. no-repeat pinta apenas uma cópia nesse eixo; não redimensiona o elemento nem impede o recorte. Com várias imagens, os estilos separados por vírgulas seguem a ordem das camadas; uma lista mais curta repete-se.

repeat preenche a área de pintura e pode deixar cópias parciais nas extremidades. space insere tantas cópias inteiras quantas couberem na área de posicionamento, encosta a primeira e a última às extremidades e distribui os intervalos. Ignora background-position nesse eixo quando cabem pelo menos duas cópias; caso contrário, uma cópia usa essa posição. round muda antes o tamanho da cópia para caber um número inteiro. Isto interage com background-size, incluindo a dimensão auto e a proporção da imagem, em vez de apenas acrescentar intervalos.

O exemplo usa um mosaico vermelho e azul de 50×20px em caixas com 120px de largura. repeat no-repeat deixa a última cópia parcialmente visível. space no-repeat pinta duas cópias inalteradas com um intervalo branco de 20px. round no-repeat cria duas cópias de 60px, cada uma com metades vermelha e azul de 30px. Uma cópia no-repeat centrada começa em 35px. Numa caixa mais estreita de 70px, space só admite uma cópia e respeita center, começando em 10px. A consola mostra os estilos calculados; uma linha real de píxeis PNG verifica cada segmento de cor e cada intervalo.

Exemplos

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);
});

Resultado

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

Executado no Chromium 157.0.8103.51 com mosaicos de gradiente de limites nítidos e linhas exatas de píxeis à razão 1. As duas dimensões de background-size são fixas; o ajuste automático de proporções com round e a sobreposição de camadas não são apresentados como casos executados.

Fontes