Luka's Playground - 개발자의 놀이터

왜 이 글을 쓰나

div 가운데 정렬을 매번 검색한다. justify-content와 align-items가 각각 뭘 하는지 헷갈린다. Grid에서 auto-fill과 auto-fit의 차이를 또 찾아본다. Flexbox 쓰다 Grid로 갔다가, 언제 무엇을 써야 하는지 기준이 없어서 감으로 결정한다.

자주 쓰는 것만 한 곳에 정리했다. 이 글 하나로 대부분의 레이아웃 패턴을 해결할 수 있도록 코드 중심으로 구성했다.

---

Flexbox 핵심 속성 정리

컨테이너 속성

.container {
  display: flex;

  /* 주축 방향 */
  flex-direction: row;           /* 기본값. 가로 */
  flex-direction: column;        /* 세로 */
  flex-direction: row-reverse;   /* 가로 역방향 */

  /* 주축 정렬 (flex-direction이 row면 가로 기준) */
  justify-content: flex-start;   /* 기본값. 시작점 */
  justify-content: flex-end;     /* 끝점 */
  justify-content: center;       /* 가운데 */
  justify-content: space-between; /* 양쪽 끝 + 사이 균등 간격 */
  justify-content: space-around;  /* 모든 아이템 양쪽 동일 간격 */
  justify-content: space-evenly;  /* 완전 균등 간격 */

  /* 교차축 정렬 (flex-direction이 row면 세로 기준) */
  align-items: stretch;          /* 기본값. 교차축 방향으로 늘림 */
  align-items: flex-start;       /* 시작점 */
  align-items: flex-end;         /* 끝점 */
  align-items: center;           /* 가운데 */
  align-items: baseline;         /* 텍스트 베이스라인 기준 */

  /* 여러 줄일 때 줄 간격 */
  align-content: flex-start;
  align-content: center;
  align-content: space-between;

  /* 줄 바꿈 */
  flex-wrap: nowrap;             /* 기본값. 한 줄 */
  flex-wrap: wrap;               /* 여러 줄 */

  /* 아이템 간격 */
  gap: 16px;                     /* 행/열 동일 */
  gap: 16px 24px;                /* 행 16px, 열 24px */
  row-gap: 16px;
  column-gap: 24px;
}

아이템 속성

.item {
  /* flex-grow / flex-shrink / flex-basis 축약 */
  flex: 1;           /* flex: 1 1 0 과 동일. 남은 공간 균등 분배 */
  flex: 0 0 200px;   /* 고정 너비 200px. 늘어나지도 줄어들지도 않음 */
  flex: 2;           /* 다른 flex:1 아이템 대비 2배 공간 */

  /* 개별 속성 */
  flex-grow: 1;      /* 남은 공간을 얼마나 가져갈지 (0이면 안 늘어남) */
  flex-shrink: 1;    /* 공간 부족 시 얼마나 줄어들지 (0이면 안 줄어듦) */
  flex-basis: auto;  /* 기본 크기 (auto면 width/height 기준) */

  /* 개별 교차축 정렬 (align-items 덮어씀) */
  align-self: center;
  align-self: flex-end;

  /* 시각적 순서 변경 (DOM 순서는 그대로) */
  order: 0;          /* 기본값 */
  order: -1;         /* 앞으로 */
  order: 1;          /* 뒤로 */
}

자주 쓰는 Flexbox 패턴

수평 + 수직 가운데 정렬

.center-both {
  display: flex;
  justify-content: center;
  align-items: center;
}

양쪽 정렬 (헤더 nav 패턴)

.space-between {
  display: flex;
  justify-content: space-between;
  align-items: center;
}

균등 분배 탭

.tabs {
  display: flex;
}

.tab-item {
  flex: 1;          /* 각 탭이 균등하게 공간 차지 */
  text-align: center;
}

나머지 공간 채우기

.layout {
  display: flex;
  height: 100vh;
}

.sidebar {
  flex: 0 0 240px;   /* 사이드바 고정 너비 */
}

.main {
  flex: 1;           /* 나머지 전체 */
  overflow: auto;
}

---

Grid 핵심 속성 정리

컨테이너 속성

.container {
  display: grid;

  /* 열 정의 */
  grid-template-columns: 200px 1fr 200px;     /* 고정-유연-고정 */
  grid-template-columns: repeat(3, 1fr);       /* 3열 균등 */
  grid-template-columns: repeat(12, 1fr);      /* 12컬럼 */
  grid-template-columns: minmax(200px, 1fr) 2fr; /* 최소-최대 범위 */

  /* 행 정의 */
  grid-template-rows: auto 1fr auto;           /* 헤더-콘텐츠-푸터 */
  grid-template-rows: 60px repeat(3, 100px);   /* 첫 줄 60px, 나머지 100px */

  /* 암묵적 행 크기 (정의되지 않은 행의 기본 크기) */
  grid-auto-rows: 200px;
  grid-auto-rows: minmax(100px, auto);

  /* 간격 */
  gap: 24px;
  row-gap: 16px;
  column-gap: 24px;

  /* 템플릿 영역 */
  grid-template-areas:
    "header header header"
    "sidebar main main"
    "footer footer footer";

  /* 정렬 */
  justify-items: start;    /* 셀 내 아이템 가로 정렬 */
  align-items: center;     /* 셀 내 아이템 세로 정렬 */
  justify-content: center; /* 그리드 전체 가로 정렬 */
  align-content: center;   /* 그리드 전체 세로 정렬 */
}

아이템 속성

.item {
  /* 열 위치/범위 */
  grid-column: 1 / 3;        /* 1번 라인 ~ 3번 라인 (2열 차지) */
  grid-column: 1 / -1;       /* 첫 번째 ~ 마지막 (전체 너비) */
  grid-column: span 2;       /* 현재 위치에서 2열 차지 */

  /* 행 위치/범위 */
  grid-row: 1 / 3;           /* 1번 ~ 3번 라인 */
  grid-row: span 2;          /* 2행 차지 */

  /* 템플릿 영역 배치 */
  grid-area: header;
  grid-area: sidebar;
  grid-area: main;

  /* 개별 정렬 */
  justify-self: end;
  align-self: center;
}

자주 쓰는 Grid 패턴

반응형 카드 그리드 (auto-fill)

.card-grid {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
  gap: 24px;
}

컨테이너 너비에 따라 자동으로 열 개수가 조정된다. 최소 너비 280px이 확보될 때마다 새 열이 생긴다.

12컬럼 레이아웃

.grid-12 {
  display: grid;
  grid-template-columns: repeat(12, 1fr);
  gap: 24px;
}

.col-4  { grid-column: span 4; }
.col-6  { grid-column: span 6; }
.col-8  { grid-column: span 8; }
.col-12 { grid-column: span 12; }

대시보드 레이아웃

.dashboard {
  display: grid;
  grid-template-columns: 240px 1fr;
  grid-template-rows: 60px 1fr;
  grid-template-areas:
    "sidebar header"
    "sidebar main";
  height: 100vh;
}

.header  { grid-area: header; }
.sidebar { grid-area: sidebar; }
.main    { grid-area: main; overflow: auto; }

---

실전 레이아웃 패턴 모음

수직 + 수평 완전 가운데 정렬

/* Flexbox */
.flex-center {
  display: flex;
  justify-content: center;
  align-items: center;
  min-height: 100vh;
}

/* Grid */
.grid-center {
  display: grid;
  place-items: center; /* justify-items + align-items 축약 */
  min-height: 100vh;
}

place-items: center가 Flexbox 두 줄을 한 줄로 대체한다. Grid에서만 동작한다.

헤더 - 사이드바 - 콘텐츠 - 푸터 레이아웃

.app-layout {
  display: grid;
  grid-template-columns: 240px 1fr;
  grid-template-rows: 60px 1fr 50px;
  grid-template-areas:
    "header  header"
    "sidebar main"
    "footer  footer";
  min-height: 100vh;
}

.app-header  { grid-area: header;  background: #1e293b; }
.app-sidebar { grid-area: sidebar; background: #0f172a; overflow-y: auto; }
.app-main    { grid-area: main;    overflow-y: auto; padding: 24px; }
.app-footer  { grid-area: footer;  background: #1e293b; }

반응형 카드 그리드 (auto-fill vs auto-fit)

/* auto-fill: 가능한 많은 열 생성, 빈 열도 공간 차지 */
.auto-fill {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(200px, 1fr));
  gap: 16px;
}

/* auto-fit: 빈 열을 접어서 아이템이 빈 공간을 채움 */
.auto-fit {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
  gap: 16px;
}

아이템 수가 적을 때 차이가 난다. auto-fill은 빈 열을 그대로 두고, auto-fit은 아이템이 남은 공간을 가져간다. 카드 그리드는 보통 auto-fill이 자연스럽다.

Sticky 헤더 + 스크롤 콘텐츠

.page {
  display: flex;
  flex-direction: column;
  height: 100vh;
}

.sticky-header {
  flex: 0 0 60px;    /* 고정 높이, 줄어들지 않음 */
  position: sticky;
  top: 0;
  z-index: 10;
}

.scrollable-content {
  flex: 1;
  overflow-y: auto;  /* 이 영역만 스크롤 */
}

Holy Grail 레이아웃 (5구역)

.holy-grail {
  display: grid;
  grid-template-columns: 200px 1fr 160px;
  grid-template-rows: auto 1fr auto;
  grid-template-areas:
    "header  header  header"
    "nav     main    aside"
    "footer  footer  footer";
  min-height: 100vh;
}

---

Flexbox vs Grid 비교 테이블

항목	Flexbox	Grid
축	1차원 (가로 또는 세로)	2차원 (가로 + 세로 동시)
적합한 상황	네비게이션, 버튼 그룹, 카드 내부	페이지 레이아웃, 대시보드, 카드 그리드
아이템 크기	콘텐츠 기반 (유연)	명시적 그리드 기반
반응형	flex-wrap으로 처리	auto-fill/auto-fit으로 자동 처리
겹침 처리	어려움	grid-area로 자연스럽게 가능
브라우저 지원	IE11 일부 지원	IE11 미지원 (구 문법 제한)
학습 난이도	낮음	중간

언제 Flexbox: 한 방향 나열 (메뉴, 버튼 그룹, 인풋 + 버튼), 아이템 크기가 콘텐츠 기반일 때

언제 Grid: 2차원 격자 배치 (카드 그리드, 대시보드), 전체 페이지 레이아웃, 비대칭 영역 배치

둘을 함께 쓰는 게 일반적이다. Grid로 페이지 구조를 잡고, 각 섹션 내부를 Flexbox로 정렬한다.

---

자주 헷갈리는 속성 비교

속성	적용 대상	동작 방향	설명
justify-content	Flex/Grid 컨테이너	주축 (row면 가로)	아이템 전체의 주축 정렬
align-items	Flex/Grid 컨테이너	교차축 (row면 세로)	각 아이템의 교차축 정렬
align-content	Flex/Grid 컨테이너	교차축	여러 줄 전체의 교차축 정렬 (단일 줄에는 효과 없음)
justify-self	Grid 아이템	가로	개별 아이템 가로 정렬 (Flex에는 없음)
align-self	Flex/Grid 아이템	세로	개별 아이템 세로 정렬
place-items	Grid 컨테이너	가로 + 세로	align-items + justify-items 축약
place-self	Grid 아이템	가로 + 세로	align-self + justify-self 축약

justify-content는 주축 기준이라 flex-direction: column이면 세로 정렬이 된다. 헷갈리는 이유가 이것 때문이다. "방향이 바뀌면 주축도 바뀐다"는 걸 기억하면 된다.

align-items vs align-content 차이

/* align-items: 각 줄 내에서 아이템 높이 정렬 */
/* align-content: 여러 줄 전체를 컨테이너 내에서 정렬 */

.container {
  display: flex;
  flex-wrap: wrap;
  height: 400px;

  align-items: center;    /* 각 줄에서 아이템을 세로 가운데 */
  align-content: center;  /* 여러 줄 전체를 컨테이너 세로 가운데 */
}

줄이 하나일 때는 align-content가 효과 없다.

---

삽질 기록

flex-shrink 때문에 아이템이 찌그러지는 문제

/* 문제: 컨테이너가 좁아지면 이미지가 찌그러짐 */
.card {
  display: flex;
}

.card-image {
  width: 80px;
  height: 80px;
  /* flex-shrink 기본값이 1이라 컨테이너 좁아지면 줄어듦 */
}

/* 해결 */
.card-image {
  width: 80px;
  height: 80px;
  flex-shrink: 0;  /* 줄어들지 않게 고정 */
}

flex-shrink: 1이 기본값이라 공간이 부족하면 자동으로 줄어든다. 아이콘, 이미지, 버튼처럼 크기가 고정이어야 하는 아이템은 flex-shrink: 0을 명시해야 한다.

---

Grid auto 크기 문제

/* 문제: grid-auto-rows를 안 주면 콘텐츠 높이에 따라 행 높이가 중구난방 */
.grid {
  display: grid;
  grid-template-columns: repeat(3, 1fr);
}

/* 해결 1: 행 높이 고정 */
.grid {
  grid-auto-rows: 200px;
}

/* 해결 2: 최소 높이 보장 + 콘텐츠에 따라 늘어남 */
.grid {
  grid-auto-rows: minmax(200px, auto);
}

카드 콘텐츠 길이가 다를 때 특히 문제가 된다. 같은 행의 카드들은 가장 높은 카드에 맞춰 높이가 결정된다. 이걸 이용하면 카드 하단 버튼 정렬도 자연스럽게 해결된다.

/* 카드 내부: 버튼을 항상 하단에 */
.card {
  display: flex;
  flex-direction: column;
}

.card-body {
  flex: 1;  /* 버튼을 아래로 밀어내는 역할 */
}

.card-button {
  margin-top: auto;
}

---

justify-content: center 했는데 아이템이 왼쪽에 붙는 문제

/* 문제: flex-wrap: wrap인데 마지막 줄 아이템이 왼쪽 정렬됨 */
.grid-like {
  display: flex;
  flex-wrap: wrap;
  justify-content: center;
}

/* 이 경우 마지막 줄 아이템이 1~2개면 중앙에 오긴 하는데,
   일관성 없는 정렬이 필요하면 Grid가 낫다 */

/* 해결: Grid로 전환 */
.grid-like {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(200px, 1fr));
  gap: 16px;
}

Flexbox는 마지막 줄 아이템 수가 적으면 정렬이 어색해진다. 동일 크기 카드를 격자로 배치할 때는 처음부터 Grid를 쓰는 게 낫다.

---

min-width: 0 처리 안 해서 텍스트 오버플로우

/* 문제: flex 아이템 내부 텍스트가 잘리지 않고 컨테이너 밖으로 튀어나옴 */
.item {
  flex: 1;
  /* min-width 기본값이 auto라 콘텐츠 크기 이하로 줄어들지 않음 */
}

/* 해결 */
.item {
  flex: 1;
  min-width: 0;  /* flex 아이템의 min-width 기본값 auto를 override */
}

.item p {
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
}

Flex 아이템의 min-width 기본값은 auto다. 즉, 내부 콘텐츠 크기 이하로는 절대 줄어들지 않는다. min-width: 0을 주면 flex-shrink가 제대로 동작해서 텍스트 줄임(ellipsis)이 작동한다.

---

CSS Custom Properties (변수)

레이아웃에서 반복되는 색상, 간격, 크기를 변수로 정의하면 일관성 유지와 테마 변경이 쉬워진다.

기본 사용법

/* :root에 전역 변수 선언 */
:root {
  --color-primary: #3b82f6;
  --color-text: #1e293b;
  --color-bg: #ffffff;

  --spacing-sm: 8px;
  --spacing-md: 16px;
  --spacing-lg: 24px;
  --spacing-xl: 48px;

  --radius-sm: 4px;
  --radius-md: 8px;
  --radius-lg: 16px;

  --shadow-md: 0 4px 6px -1px rgb(0 0 0 / 0.1);
}

/* 사용 */
.button {
  background: var(--color-primary);
  padding: var(--spacing-sm) var(--spacing-md);
  border-radius: var(--radius-md);
}

다크 모드 테마 전환

:root {
  --color-bg: #ffffff;
  --color-text: #1e293b;
  --color-surface: #f8fafc;
}

[data-theme="dark"] {
  --color-bg: #0f172a;
  --color-text: #f1f5f9;
  --color-surface: #1e293b;
}

/* 컴포넌트는 변수만 쓰면 테마 자동 전환 */
.card {
  background: var(--color-surface);
  color: var(--color-text);
}

JS에서 테마 전환:

document.documentElement.setAttribute('data-theme', 'dark');

컴포넌트 내 로컬 변수

/* 전역 변수를 컴포넌트 단위로 재정의 */
.card {
  --card-padding: var(--spacing-md);
  --card-radius: var(--radius-md);

  padding: var(--card-padding);
  border-radius: var(--card-radius);
}

/* 변형 컴포넌트는 로컬 변수만 바꾸면 됨 */
.card--compact {
  --card-padding: var(--spacing-sm);
}

.card--large {
  --card-padding: var(--spacing-xl);
  --card-radius: var(--radius-lg);
}

폴백 값

.element {
  /* 변수가 없을 때 대체값 */
  color: var(--color-accent, #3b82f6);
  gap: var(--custom-gap, 16px);
}

---

Container Queries

2023년 전 브라우저 지원 완료. 뷰포트가 아닌 부모 컨테이너 크기를 기준으로 스타일을 변경한다. 컴포넌트 기반 반응형에 적합하다.

기본 사용법

/* 1. 부모에 container 설정 */
.card-wrapper {
  container-type: inline-size;  /* 가로 크기 기준 */
  container-name: card;         /* 이름 지정 (선택) */
}

/* 2. 자식에서 @container 쿼리 적용 */
.card {
  display: flex;
  flex-direction: column;
}

@container (min-width: 400px) {
  .card {
    flex-direction: row;  /* 컨테이너가 400px 이상이면 가로 배치 */
  }
}

@container (min-width: 600px) {
  .card {
    grid-template-columns: 200px 1fr;
  }
}

Media Queries vs Container Queries 비교

항목	Media Queries	Container Queries
기준	브라우저 뷰포트	부모 컨테이너
적합한 상황	페이지 전체 레이아웃	재사용 컴포넌트
사이드바 안 카드	뷰포트 기준이라 부정확	사이드바 크기 기준으로 정확
브라우저 지원	전체 지원	2023년 이후 전체 지원

실전 활용 — 재사용 카드 컴포넌트

/* 카드를 어디에 배치하든 컨테이너 크기에 맞게 자동 조정 */
.card-container {
  container-type: inline-size;
}

.card {
  padding: 16px;
}

.card__image {
  width: 100%;
  aspect-ratio: 16 / 9;
}

/* 넓은 컨테이너에서는 이미지 + 텍스트 가로 배치 */
@container (min-width: 480px) {
  .card {
    display: grid;
    grid-template-columns: 160px 1fr;
    gap: 16px;
  }

  .card__image {
    aspect-ratio: 1;
  }
}

같은 컴포넌트를 메인 콘텐츠 영역(넓음)과 사이드바(좁음)에 각각 배치해도 컨테이너 크기에 맞게 알아서 레이아웃이 전환된다. 뷰포트 기반 Media Queries로는 이 동작을 구현하기 어렵다.

---

마무리

Flexbox와 Grid는 함께 쓰는 도구다. 하나를 선택하는 게 아니라, 상황에 맞게 조합한다.

기준은 단순하다. 한 방향 배치면 Flexbox, 2차원 격자면 Grid. 전체 페이지 레이아웃은 Grid로, 버튼 그룹이나 내비게이션은 Flexbox로 잡으면 대부분 해결된다.

헷갈리는 속성은 외우려 하지 말고 이 글처럼 레퍼런스로 두고 찾아보는 게 빠르다. 어차피 쓰다 보면 자주 쓰는 것들은 자연스럽게 외워진다.

---

언어: CSS3
테스트 도구: CSS Grid Generator, Flexbox Froggy, Grid Garden