반응형 웹사이트를 만들다 보면 답답한 순간이 온다. CSS 미디어 쿼리는 항상 뷰포트 너비를 기준으로만 동작하기 때문이다. 사이드바가 있는 페이지에서 메인 콘텐츠 영역은 화면이 충분히 넓어도 실제 공간이 부족할 수 있지만, 미디어 쿼리는 이를 알 수 없다. 결국 부모 레이아웃의 변화에 상관없이 자식 컴포넌트는 뷰포트 기준으로만 스타일을 결정한다.

이번에는 CSS Container Queries를 정확히 뭔지, 왜 필요한지, 그리고 어떻게 실무에서 활용하는지 완벽하게 정리해서 소개하겠다.

 

뷰포트 기반 미디어 쿼리의 문제점

@media 쿼리는 지난 10년간 반응형 웹 디자인의 핵심이었다. 화면 너비에 따라 레이아웃을 바꾸는 방식은 직관적이고 구현하기 간단했다. 그러나 현대 웹 애플리케이션은 훨씬 복잡한 구조를 가진다.

예를 들어 사이드바가 있는 대시보드 페이지를 생각해보자. 사이드바 너비가 250px이고 메인 콘텐츠 영역이 남은 공간을 차지한다면, 전체 화면이 1024px일 때 메인 영역은 774px이다. 그런데 @media(min-width: 1024px) 규칙을 적용하면 사이드바 때문에 실제로는 공간이 부족해도 너비가 넓은 스타일이 적용된다. 결국 컴포넌트는 자신이 배치된 실제 컨테이너 크기를 모르고, 뷰포트 크기만 본다.

더 큰 문제는 재사용성이다. 같은 카드 컴포넌트를 두 곳에 배치했는데, 한쪽은 넓은 영역에, 다른 한쪽은 좁은 영역에 놓여있다면? @media 쿼리만으로는 각 상황에 최적화된 스타일을 적용할 수 없다. 결국 HTML 마크업까지 달라져야 한다.

 

Container Queries 기본 개념

Container Queries는 뷰포트가 아닌 부모 컨테이너의 크기를 기준으로 자식 요소의 스타일을 변경한다. 뷰포트 너비 대신 실제 배치 공간을 감시하는 방식이다.

동작 방식은 두 단계다. 먼저 부모 요소를 컨테이너로 선언하고, 그 자식에서 @container 쿼리로 부모의 크기 변화를 감지한다. 예를 들어 카드 컴포넌트의 부모를 "card-container"로 이름 짓고, 카드가 부모 크기에 따라 어떻게 반응할지 정의하는 식이다.

특성 @media Query @container Query
기준점 뷰포트 크기 부모 컨테이너 크기
재사용성 마크업 변경 필요 같은 마크업 재사용 가능
컴포넌트 독립성 부모 레이아웃 영향 받음 부모 크기만 고려
브라우저 지원 거의 모든 브라우저 2024년 기준 주요 브라우저 지원 시작

 

Container Queries 실전 구현

1단계: 부모 컨테이너 선언

먼저 감시할 부모 요소에 container-type을 지정한다. inline-size는 가로 크기만 감시하고, size는 가로세로 모두 감시한다.

.card-wrapper {
  container-type: inline-size;
  container-name: card-container;
}

2단계: 컨테이너 쿼리로 자식 스타일 정의

이제 자식 요소에서 부모 컨테이너 크기에 따라 다른 스타일을 적용한다.

.card {
  display: grid;
  grid-template-columns: 100px 1fr;
  gap: 1rem;
}

@container card-container (max-width: 300px) {
  .card {
    grid-template-columns: 1fr;
  }
}

@container card-container (min-width: 400px) {
  .card {
    grid-template-columns: 150px 1fr;
    gap: 2rem;
  }
}

3단계: HTML에는 변화 없음

<div class="card-wrapper">
  <article class="card">
    <img src="thumbnail.jpg" alt="" />
    <div class="card-content">
      <h3>제목</h3>
      <p>설명</p>
    </div>
  </article>
</div>

이 카드는 동일한 HTML로 여러 곳에 배치될 수 있다. 부모 컨테이너 크기에 따라 자동으로 최적화된 레이아웃이 적용된다.

 

실무 활용: 복잡한 레이아웃 예제

대시보드 레이아웃에서 사이드바와 메인 콘텐츠가 함께 있는 상황을 다시 생각해보자.

.dashboard {
  display: grid;
  grid-template-columns: 250px 1fr;
  gap: 2rem;
}

.sidebar {
  container-type: inline-size;
  container-name: sidebar;
}

.main {
  container-type: inline-size;
  container-name: main-content;
}

/* 사이드바 내 위젯: 좁은 공간에 최적화 */
.widget {
  display: grid;
  grid-template-columns: repeat(2, 1fr);
  gap: 1rem;
}

@container sidebar (max-width: 200px) {
  .widget {
    grid-template-columns: 1fr;
  }
}

/* 메인 콘텐츠 카드: 넓은 공간에서 자유로움 */
.content-card {
  padding: 2rem;
}

@container main-content (max-width: 600px) {
  .content-card {
    padding: 1rem;
  }
}

@container main-content (min-width: 1000px) {
  .content-card {
    display: grid;
    grid-template-columns: repeat(3, 1fr);
    gap: 2rem;
  }
}

이제 전체 레이아웃이 반응형이 된다. 사이드바를 여닫거나 너비를 조정해도 각 영역이 자신의 실제 공간에 맞춰 자동으로 조정된다.

 

잘못된 사용과 올바른 방법

✗ 잘못된 방법: 모든 요소에 container-type 설정

/* 과도하게 모든 곳에 container-type을 붙이면 렌더링 성능 저하 */
div {
  container-type: inline-size;
}

.card {
  container-type: inline-size;
}

.card-title {
  container-type: inline-size; /* 불필요 */
}

✓ 올바른 방법: 필요한 곳에만 컨테이너 선언

/* 레이아웃 변화가 필요한 부모 요소에만 설정 */
.card-wrapper {
  container-type: inline-size;
  container-name: card;
}

.card {
  /* 여기서는 container-type 불필요 */
}

.card-title {
  /* 자식 요소는 @container로만 스타일 정의 */
}

✗ 잘못된 방법: @media와 @container 혼용으로 혼동 유발

.component {
  font-size: 1rem;
}

@media (min-width: 768px) {
  .component {
    font-size: 1.2rem; /* 뷰포트 기준 */
  }
}

@container (min-width: 500px) {
  .component {
    font-size: 1.1rem; /* 컨테이너 기준 */
  }
}
/* 두 규칙이 동시에 적용되면 우선순위가 헷갈린다 */

✓ 올바른 방법: 명확한 역할 분담

.component {
  font-size: 1rem; /* 기본값 */
}

/* @media는 전체 레이아웃 변화용 */
@media (min-width: 768px) {
  .dashboard {
    grid-template-columns: 250px 1fr; /* 사이드바-메인 레이아웃 */
  }
}

/* @container는 컴포넌트 내부 미세조정용 */
@container card-wrapper (min-width: 400px) {
  .component {
    font-size: 1.1rem; /* 카드 크기에 따른 조정 */
  }
}

 

브라우저 호환성 처리

2024년 기준 대부분의 현대 브라우저가 Container Queries를 지원하지만, 레거시 브라우저 대응이 필요하면 폴백(fallback) CSS를 준비하자.

.card {
  /* 폴백: 모든 브라우저에서 작동하는 기본 레이아웃 */
  display: grid;
  grid-template-columns: 100px 1fr;
  gap: 1rem;
}

/* Container Queries 지원 브라우저에서만 적용 */
@supports (container-type: inline-size) {
  .card-wrapper {
    container-type: inline-size;
  }

  @container (max-width: 300px) {
    .card {
      grid-template-columns: 1fr;
    }
  }
}

 

마무리: 컴포넌트 기반 설계의 미래

Container Queries는 단순한 CSS 기능이 아니라 현대적인 컴포넌트 기반 웹 개발 방식을 완벽히 지원하는 도구다. 부모 레이아웃에 영향받지 않고 독립적으로 작동하는 컴포넌트를 만들 수 있다는 것은 유지보수와 재사용성을 획기적으로 높인다. 사이드바를 추가하거나 제거해도, 모바일과 데스크톱을 구분해도 컴포넌트는 자신의 공간에 맞춰 자동으로 최적화된다.

이 글의 container-type 선언과 @container 쿼리 작성 방법을 참고해 기존 프로젝트의 반응형 CSS를 리팩토링해보자. 한 두 컴포넌트씩 적용하다 보면 코드 복잡도는 줄고 유연성은 높아지는 경험을 할 수 있을 것이다.