CSS background-repeat: repita, espace ou redimensione imagens de fundo

No CSS, background-repeat controla como uma imagem de fundo se repete. Use no-repeat para uma cópia, repeat-x para repetir na horizontal ou repeat-y para repetir na vertical. Para evitar peças cortadas, space insere intervalos e round ajusta o tamanho.

Escolha o valor e a direção

Valor Efeito
repeat Repete nos dois eixos. É o valor inicial e pode cortar cópias nas bordas.
repeat-x / repeat-y Repete apenas na horizontal ou apenas na vertical, respectivamente.
no-repeat Mostra uma única cópia.
space Posiciona cópias inteiras e divide a sobra de espaço entre elas.
round Redimensiona a imagem para encaixar um número inteiro de cópias.

Com dois valores, o primeiro vale para a horizontal e o segundo para a vertical. repeat no-repeat equivale a repeat-x. space no-repeat distribui os intervalos na horizontal e mostra uma só linha.

Especificação do W3C para repetição de imagens de fundo

Compare quatro valores com o mesmo ladrilho

Salve o código completo como background-repeat-example.html em UTF-8 e abra-o no navegador. Cada caixa mede 220×120px e usa uma peça de 80×40px gerada com um gradiente CSS.

<!doctype html>
<html lang="pt">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Compare quatro valores com o mesmo ladrilho</title>
  <style>
    .tile {
      width: 220px;
      max-width: 100%;
      height: 120px;
      background-color: #f7f9fc;
      background-image: linear-gradient(125deg, #254aa5 48%, #9ce5cc 48% 75%, #dbeafe 75%);
      background-size: 80px 40px;
      background-position: left top;
    }
    .single { background-repeat: no-repeat; }
    .repeat { background-repeat: repeat; }
    .space { background-repeat: space; }
    .round { background-repeat: round; }
  </style>
</head>
<body>
  <p>no-repeat</p>
  <div class="tile single"></div>
  <p>repeat</p>
  <div class="tile repeat"></div>
  <p>space</p>
  <div class="tile space"></div>
  <p>round</p>
  <div class="tile round"></div>
</body>
</html>

no-repeat mostra uma peça no canto superior esquerdo. repeat corta a última peça na borda direita. space deixa a cor de fundo visível entre as colunas e round estreita as peças. Altere apenas a repetição para comparar com as mesmas dimensões.

A mesma peça de fundo aparece uma vez, repetida com a borda cortada, espaçada em duas colunas e redimensionada para três

A diferença entre space e round

Com space, duas peças de 80px encostam nas bordas horizontais e deixam 60px entre elas. Quando só uma cópia cabe em um eixo, background-position define sua posição nesse eixo. Teste 140px de largura e right top para ver a peça na borda direita.

Com round, 220 ÷ 80 resulta em 2,75, arredondado para três cópias. Cada uma fica com cerca de 73,33px de largura. Na vertical já cabem três peças de 40px. Ajustes diferentes em cada eixo podem alterar a proporção da imagem.

Cálculo do tamanho com round na especificação do W3C

Ajuste várias camadas de fundo

Quando há várias imagens de fundo separadas por vírgulas, a primeira fica por cima. Escreva os valores de background-repeat na mesma ordem.

.card {
  background-image:
    radial-gradient(circle, #b45309 40%, transparent 42%),
    linear-gradient(135deg, #eff6ff 50%, #dbeafe 50%);
  background-size: 32px 32px, 64px 64px;
  background-repeat: no-repeat, repeat;
}

O código mostra o círculo pequeno uma vez e repete o padrão diagonal abaixo. Um único valor de repetição é usado em todas as camadas. Separe os valores se cada camada precisar de um comportamento diferente.

Quando o fundo se repete de forma inesperada

Se a direção estiver correta mas o número de cópias surpreender, veja background-size e a largura da caixa nas ferramentas de desenvolvedor. Um tamanho como cover pode preencher toda a área visível.

Uma abreviação background aplicada depois pode voltar para repeat se omitir a repetição. Inclua no-repeat ou o valor desejado na abreviação, ou declare background-repeat depois.