Hex에서 OKLCH로: Tailwind CSS v4 디자인 토큰 마이그레이션 가이드
기존 Hex/HSL Tailwind v3 테마를 CSS Color 4 @theme oklch() 스케일로 전환해 균일한 밝기와 Display P3를 지원하는 방법을 안내합니다.
6분 분량 · 업데이트 2026-11-22
요약 비교
| 비교 항목 | 기존 Hex / HSL (Tailwind v3) | OKLCH @theme (Tailwind v4) |
|---|---|---|
| 작성 방식 | tailwind.config.js Hex 문자열 | CSS @theme --color-* : oklch(...) |
| 지각 균일성 | 아니오 (노랑이 파랑보다 훨씬 밝음) | 예 (L 축이 체감 밝기와 일치) |
| 광색역 P3 | 8비트 sRGB에 제한 | Display P3 및 Rec.2020 네이티브 지원 |
| 런타임 틴트 | 전처리기 연산 필요 | 네이티브 CSS oklch(from var(--c) ...) |
Tailwind v4가 기본 팔레트를 Hex에서 OKLCH로 바꾼 이유
기존 sRGB Hex 표기는 눈으로 느끼는 밝기를 숨깁니다. 파랑 500과 노랑 500은 숫자 단계가 같아도 접근성 대비가 극단적으로 다릅니다.
OKLCH는 지각 명도(L)를 첫 번째 축에 두어 색조를 바꿔도 버튼과 배지의 시각적 무게감이 일정하게 유지됩니다.
- 50–950 스케일 대비가 일관되어 50–400에는 어두운 글자, 600–950에는 흰 글자가 안정적으로 통과합니다.
- Sass나 PostCSS 플러그인 없이 순수 CSS 상대 색상을 활용합니다.
tailwind.config.js Hex 토큰을 CSS @theme로 매핑하기
기존 theme.extend.colors 또는 :root 변수를 Colr 변환기에 붙여넣으면 D65 선형 sRGB를 거쳐 정확한 W3C oklch() 선언을 얻습니다.
가장 밝은 단계(50–100)에서는 sRGB 범위를 넘지 않도록 채도를 낮게 유지하세요.
tailwind.config.js Hex 토큰을 CSS @theme로 매핑하기
CSS@import "tailwindcss";
@theme {
--color-brand-50: oklch(97.2% 0.014 261.2);
--color-brand-500: oklch(54.6% 0.215 262.9);
--color-brand-700: oklch(42.4% 0.178 263.5);
--color-brand-950: oklch(23.1% 0.086 264.1);
}전환 후 WCAG 2.2 및 APCA 명도 대비 재검증
배포 전 변환된 50–950 스케일을 대비 매트릭스에 통과시켜 특히 500–600 버튼 위 흰 글씨 가독성을 검증하세요.
OKLCH 스케일 생성기는 WCAG AA와 APCA Lc 기준선을 즉시 표시해 줍니다.
- 500 및 600 단계에서 일반 본문 버튼 대비 4.5:1 충족 확인.
- 일반 sRGB 화면에서의 폴백 표시도 함께 미리보기.
가이드에 소개된 도구
관련 포맷
자주 묻는 질문
CSS oklch()를 쓰면 구형 브라우저에서 깨지지 않나요?
2023년 이후 출시된 모든 Chrome, Safari, Firefox, Edge는 oklch()를 기본 지원하며 필요시 Hex 폴백을 병행할 수 있습니다.
일반 sRGB 모니터에서도 원래 Hex와 똑같이 보이나요?
네, 채도를 Display P3 영역으로 의도적으로 높이지 않는 한 동일한 색으로 렌더링됩니다.
더 많은 컬러 가이드
- OKLCH vs HSL vs sRGB: 와이드 가멋 Display P3 완벽 이해HSL, sRGB Hex, Display P3, OKLCH의 지각 밝기, 그라데이션 탁함, 색역 부피 및 CSS 점진적 향상 전략을 비교합니다.
- W3C Design Tokens (DTCG 2025.10): Figma 변수를 CSS로 연결하기W3C DTCG 2025.10 JSON 구조($type, $value colorSpace & components, 별칭)로 Figma와 CSS / Tailwind v4를 손실 없이 연동합니다.
- WCAG 2.2 명도 대비 vs APCA (Lc): 완벽한 컬러 접근성 가이드WCAG 2.2 상대 휘도 비율(4.5:1)과 최신 APCA 지각 명도 대비(Lc 60/75/90), 다크 모드 극성 및 색각 시뮬레이션 활용법을 정리합니다.
- 같은 색을 RGB, HSL, HSV, HWB, OKLab으로 비교하기기준색 #336699로 색상 선택기와 CSS 선언, 셰이더의 값을 확인합니다. 같은 색의 여덟 가지 표기와 왕복 변환의 정밀도를 비교합니다.