CSS / Reference / background-repeat

CSS background-repeat는 배경 이미지가 요소 안에서 반복되는 방향과 방식을 정합니다. 한 장만 표시하려면 no-repeat, 가로로만 반복하려면 repeat-x, 세로로만 반복하려면 repeat-y를 사용합니다. 타일을 자르지 않으려면 원래 크기 사이에 간격을 두는 space와 타일 크기를 바꾸는 round를 비교하세요.

반복 방향과 값 고르기

값 배치 방식
repeat 가로와 세로로 반복합니다. 기본값이며 가장자리 타일은 잘릴 수 있습니다.
repeat-x / repeat-y 가로로만 / 세로로만 반복합니다.
no-repeat 반복 없이 한 장을 표시합니다.
space 온전한 타일을 넣고 남은 길이를 타일 사이에 나눕니다.
round 타일이 정수 개 들어가도록 타일 크기를 조정합니다.

값을 두 개 쓰면 앞이 가로, 뒤가 세로입니다. 예를 들어 repeat no-repeat는 repeat-x와 같고, space no-repeat는 세로로 반복하지 않고 가로 타일 사이에 간격을 둡니다.

W3C CSS 명세의 배경 이미지 반복 방식

같은 타일로 네 가지 값 비교하기

다음 전체 코드를 UTF-8 형식의 background-repeat-example.html로 저장해 브라우저에서 여세요. 모든 상자는 220×120px이며, 그라디언트로 만든 80×40px 타일을 사용하므로 별도 이미지 파일이 필요 없습니다.

<!doctype html>
<html lang="ko">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>같은 타일로 네 가지 값 비교하기</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는 왼쪽 위의 타일만 보이고, repeat는 오른쪽 가장자리에서 마지막 타일이 잘립니다. space는 가로 타일 사이로 바탕색이 보이고, round는 형태가 조금 좁아지면서 가로를 채웁니다. 상자의 너비와 타일 크기를 유지한 채 반복값만 바꾸면 차이를 분리해 확인할 수 있습니다.

같은 배경 타일을 한 장만 표시하거나 가장자리를 자른 채 반복하거나, 간격을 두거나 폭을 줄여 배치한 네 가지 결과

space와 round의 차이

space에서는 가로 80px 타일 두 개가 양끝을 채우고 가운데에 60px 간격이 생깁니다. 한 축에 타일 두 개가 들어가지 않으면 그 축에는 한 장만 놓이고, background-position으로 그 위치를 정합니다. 예를 들어 너비를 140px, 위치를 right top으로 바꾸면 한 장이 오른쪽으로 갑니다.

round에서는 220px을 80px으로 나눈 2.75를 반올림해 세 장을 맞춥니다. 가로 한 장은 약 73.33px이고, 세로는 40px 타일 세 장이 이미 들어가므로 그대로입니다. 가로와 세로의 조정 폭이 다르면 이미지의 비율이 달라질 수 있습니다.

W3C CSS 명세의 round 크기 계산

배경 이미지가 여러 겹일 때

배경 이미지를 쉼표로 여러 개 쓰면 첫 번째 이미지가 가장 위에 놓입니다. background-repeat도 같은 순서로 값을 나열합니다.

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

이 코드는 위쪽의 작은 원을 한 번만 표시하고, 아래쪽의 대각선 무늬를 반복합니다. 반복값을 하나만 지정하면 모든 레이어가 그 값을 공유합니다. 레이어별 차이가 필요하면 값을 순서에 맞춰 적으세요.

반복이 예상과 다를 때

반복 방향은 맞는데 타일 개수가 다르면 개발자 도구에서 background-size와 상자 너비부터 확인하세요. cover처럼 큰 배경 크기를 쓰면 반복 설정이 켜져 있어도 여러 타일이 보이지 않을 수 있습니다.

같은 요소에 나중에 적용되는 background 단축 선언이 반복값을 생략하면 repeat로 돌아갈 수 있습니다. 단축 선언 안에 no-repeat 등을 넣거나 그 뒤에 background-repeat를 선언하세요.

반복에 사용하는 타일 크기를 정하려면 CSS background-size 사용 방법을 참고하세요.