헷갈리기 쉬운 상황
container query 설계: 정상처럼 보이는 한 사례만으로는 동작 범위를 이해하기 어렵습니다. 대표 입력에서는 문제없다가 경계값, 느린 응답, 배포 직후처럼 조건이 달라질 때 결과가 바뀔 수 있습니다.
container query는 viewport가 아니라 지정한 containment box 크기를 기준으로 component를 바꾸므로 container 지정과 fallback이 필요합니다.
핵심 원리
cascade, layout, paint와 compositing 단계를 거쳐 화면을 구성하는 CSS 렌더링 계층에서 어느 경계가 결과를 결정하는지 먼저 봅니다. computed style만 보지 않고 containing block, intrinsic size, overflow와 stacking context를 확인합니다. 어떤 box가 크기를 결정하는지부터 찾습니다.
| 구분 | 짧은 예시 |
|---|---|
| 기대 결과 | container query 설계: 정상 조건에서 사용자가 받아야 할 결과 |
| 실제 결과 | 같은 입력에서 처음 달라진 값·상태·오류 |
| 판별 자료 | computed style, cascade layer, layout shift, paint flashing과 overflow 원소의 실제 경계 상자를 본다 |
실무에서 확인할 것
레이아웃 제약을 명시하고 크기 변화는 layout보다 transform을 우선하되 측정 결과로 결정한다. 부모와 자식의 크기 제약을 명시하고 문제를 만든 최소 layout 규칙만 고칩니다. 임의의 큰 z-index나 고정 높이로 증상을 가리지 않습니다.
대표 사례 하나, 값이 달라지는 경계 하나, 예상 가능한 실패 하나를 같은 순서로 확인합니다. 지원 viewport, 확대율, 긴 문자열, 동적 콘텐츠와 reduced-motion 조건에서 시각 회귀를 확인한다. 지원 viewport, 200% 확대, 긴 문자열, 동적 콘텐츠와 keyboard focus 조건에서 잘림·겹침·예상 밖 scroll이 없는지 확인합니다.
공식 문서와 적용 범위
문서의 기본값과 동작은 version에 따라 달라질 수 있습니다. 지원하는 browser, viewport, 입력 방식과 실제 network 조건에서 다시 확인합니다.