CSS background-repeat: cómo repetir o ajustar una imagen de fondo
En CSS, background-repeat controla cómo se repite una imagen de fondo. Usa no-repeat para mostrarla una sola vez, repeat-x para repetirla horizontalmente y repeat-y para repetirla en vertical. Para evitar piezas recortadas, space deja huecos y round modifica el tamaño.
Elige el valor y la dirección
| Valor | Cómo funciona |
|---|---|
repeat |
Repite en ambos ejes. Es el valor inicial y puede recortar las piezas de los bordes. |
repeat-x / repeat-y |
Repite solo en horizontal o solo en vertical, respectivamente. |
no-repeat |
Pinta una sola pieza. |
space |
Coloca piezas completas y reparte el espacio sobrante entre ellas. |
round |
Ajusta el tamaño para que quepa un número entero de piezas. |
Con dos valores, el primero corresponde al eje horizontal y el segundo al vertical. repeat no-repeat equivale a repeat-x. space no-repeat reparte los huecos en horizontal y pinta una sola fila.
Especificación del W3C sobre repetición de fondos
Compara cuatro valores con la misma pieza
Guarda el código completo como background-repeat-example.html en UTF-8 y ábrelo en el navegador. Cada caja mide 220×120px y contiene una pieza de 80×40px creada con un degradado CSS.
<!doctype html>
<html lang="es">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Compara cuatro valores con la misma pieza</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>
Con no-repeat ves una pieza arriba a la izquierda. repeat corta la última pieza del borde derecho. space deja ver el color de fondo entre columnas y round estrecha las piezas. Para separar los efectos, modifica solo el valor de repetición.
En qué se diferencian space y round
Con space, dos piezas de 80px tocan los bordes horizontales y dejan 60px entre ellas. Si en un eje no caben dos, background-position determina la posición de la única pieza. Prueba con 140px de ancho y right top para verla pegada al borde derecho.
Con round, 220 ÷ 80 da 2,75, que se redondea a tres piezas. Cada una queda de unos 73,33px de ancho. En vertical ya caben tres de 40px. Si los ajustes de los dos ejes son distintos, pueden cambiar las proporciones de la imagen.
Cálculo del tamaño con round en la especificación del W3C
Controla varias capas de fondo
Cuando separas las imágenes de fondo con comas, la primera queda encima. Escribe los valores de background-repeat en el mismo orden.
.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;
}
El código muestra el círculo pequeño una vez y repite el patrón diagonal que queda debajo. Si escribes un solo valor de repetición, se aplica en todas las capas. Usa valores separados cuando necesites un comportamiento distinto por capa.
Si el fondo se repite de forma inesperada
Si la dirección es correcta pero el número de piezas no coincide con lo esperado, revisa background-size y el ancho de la caja en las herramientas de desarrollo. Con cover, la imagen puede ocupar todo el espacio visible.
Una declaración abreviada background que se aplique después puede restablecer repeat si omite la repetición. Incluye no-repeat o el valor deseado en esa declaración, o coloca background-repeat después.



