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 축이 체감 밝기와 일치)
광색역 P38비트 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 v3 테마를 v4 OKLCH로 변환

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 화면에서의 폴백 표시도 함께 미리보기.

접근성 높은 OKLCH 50–950 스케일 만들기

가이드에 소개된 도구

관련 포맷

자주 묻는 질문

CSS oklch()를 쓰면 구형 브라우저에서 깨지지 않나요?

2023년 이후 출시된 모든 Chrome, Safari, Firefox, Edge는 oklch()를 기본 지원하며 필요시 Hex 폴백을 병행할 수 있습니다.

일반 sRGB 모니터에서도 원래 Hex와 똑같이 보이나요?

네, 채도를 Display P3 영역으로 의도적으로 높이지 않는 한 동일한 색으로 렌더링됩니다.

더 많은 컬러 가이드