반응형 웹사이트를 만들다 보면 답답한 순간이 온다. CSS 미디어 쿼리는 항상 뷰포트 너비를 기준으로만 동작하기 때문이다. 사이드바가 있는 페이지에서 메인 콘텐츠 영역은 화면이 충분히 넓어도 실제 공간이 부족할 수 있지만, 미디어 쿼리는 이를 알 수 없다. 결국 부모 레이아웃의 변화에 상관없이 자식 컴포넌트는 뷰포트 기준으로만 스타일을 결정한다.
이번에는 CSS Container Queries를 정확히 뭔지, 왜 필요한지, 그리고 어떻게 실무에서 활용하는지 완벽하게 정리해서 소개하겠다.
@media 쿼리는 지난 10년간 반응형 웹 디자인의 핵심이었다. 화면 너비에 따라 레이아웃을 바꾸는 방식은 직관적이고 구현하기 간단했다. 그러나 현대 웹 애플리케이션은 훨씬 복잡한 구조를 가진다.
예를 들어 사이드바가 있는 대시보드 페이지를 생각해보자. 사이드바 너비가 250px이고 메인 콘텐츠 영역이 남은 공간을 차지한다면, 전체 화면이 1024px일 때 메인 영역은 774px이다. 그런데 @media(min-width: 1024px) 규칙을 적용하면 사이드바 때문에 실제로는 공간이 부족해도 너비가 넓은 스타일이 적용된다. 결국 컴포넌트는 자신이 배치된 실제 컨테이너 크기를 모르고, 뷰포트 크기만 본다.
더 큰 문제는 재사용성이다. 같은 카드 컴포넌트를 두 곳에 배치했는데, 한쪽은 넓은 영역에, 다른 한쪽은 좁은 영역에 놓여있다면? @media 쿼리만으로는 각 상황에 최적화된 스타일을 적용할 수 없다. 결국 HTML 마크업까지 달라져야 한다.
Container Queries는 뷰포트가 아닌 부모 컨테이너의 크기를 기준으로 자식 요소의 스타일을 변경한다. 뷰포트 너비 대신 실제 배치 공간을 감시하는 방식이다.
동작 방식은 두 단계다. 먼저 부모 요소를 컨테이너로 선언하고, 그 자식에서 @container 쿼리로 부모의 크기 변화를 감지한다. 예를 들어 카드 컴포넌트의 부모를 "card-container"로 이름 짓고, 카드가 부모 크기에 따라 어떻게 반응할지 정의하는 식이다.
| 특성 | @media Query | @container Query |
|---|---|---|
| 기준점 | 뷰포트 크기 | 부모 컨테이너 크기 |
| 재사용성 | 마크업 변경 필요 | 같은 마크업 재사용 가능 |
| 컴포넌트 독립성 | 부모 레이아웃 영향 받음 | 부모 크기만 고려 |
| 브라우저 지원 | 거의 모든 브라우저 | 2024년 기준 주요 브라우저 지원 시작 |
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를 리팩토링해보자. 한 두 컴포넌트씩 적용하다 보면 코드 복잡도는 줄고 유연성은 높아지는 경험을 할 수 있을 것이다.