OKLCH 색상
OKLCH는 밝기(Lightness), 채도(Chroma), 색조(Hue)가 유용한 디자인 제어 요소인 지각적으로 균일한 색상 공간입니다. 프로젝트가 이미 OKLCH를 사용 중이거나, 새로운 색상 시스템을 만들 때, 또는 사용자가 변환이나 팔레트 작업을 요청할 때 사용하세요. 그렇지 않은 경우 프로젝트의 기존 토큰과 표기법을 유지하세요. 일관된 Hex 또는 RGB 토큰 시스템은 고립된 수정을 위해 두 번째 색상 표현을 도입하는 것보다 낫습니다. 대화형으로 탐색하려면 oklch.fyi를 방문하세요.
빠른 참조
| 범주 | 사용 시기 | 참조 문서 |
|---|---|---|
| 변환 | Hex/rgb/hsl을 oklch로 | color-conversion.md |
| 팔레트 | 스케일 생성, 다중 색조, 다크 모드 | palette-generation.md |
| 대비 | APCA/WCAG 검사, 실패 보고, 요청 시 수정 | accessibility-contrast.md |
| 색역 및 Tailwind | P3 폴백, @theme 스케일, 색역 클램핑 | gamut-and-tailwind.md |
| 사용법 | 의미론적 토큰, 색상당 하나의 의미, 기본 액션 강조, 모양 변형 | color-usage.md |
핵심 원칙
1. 지각적 색상 공간 사용
- 기존 시스템을 존중하세요. 이 스킬이 로드되었다고 해서 표기법을 변환하지 마십시오. 작업에 색상 시스템 마이그레이션이 포함되지 않는 한 프로젝트의 의미론적 토큰과 작성 형식을 재사용하세요.
- 지각적 균일성. 동일한 L 단계 = 동일한 밝기.
oklch(0.5 ...)는 시각적으로 중간입니다. HSL의lightness: 50%는 색조에 따라 크게 달라집니다. - 안정적인 색조. HSL 파란색은 밝기가 변함에 따라 보라색 쪽으로 이동합니다. OKLCH 색조는 전체 밝기 범위에서 일정하게 유지됩니다.
- 독립적인 채도. 채도는 밝기와 무관한 색상의 절대적인 척도입니다. HSL 채도는 그렇지 않습니다.
- 유한한 색역. 모든 oklch 값이 표시 가능한 sRGB 색상에 매핑되는 것은 아닙니다. 특정 색조에서 높은 채도 값은 클리핑됩니다. 색역 인식이 필요합니다.
2. OKLCH를 일관되게 작성하고 형식화
oklch(L C H)
oklch(L C H / alpha)
| 채널 | 범위 | 설명 |
|---|---|---|
| L (밝기) | 0–1 | 0 = 검정, 1 = 흰색. 지각적으로 균일. |
| C (채도) | 0–~0.4 | 색상의 선명도. 0 = 회색. 최대값은 L과 H에 따라 다름. |
| H (색조) | 0–360 | 도 단위의 색조 각도. |
| alpha | 0–1 | 선택적 투명도. 슬래시 구문. |
oklch(0.637 0.237 25.331)
oklch(0.8 0.05 200 / 0.5)
L과 C는 소수점 세 자리, H는 최대 세 자리를 사용하세요. 뒤따르는 0을 제거하고 -0은 0으로 형식화하세요. OKLCH는 Baseline 2023입니다. 지원 요구 사항이 비정상적으로 광범위할 때는 고정된 글로벌 적용 범위 백분율에 의존하는 대신 대상 프로젝트의 브라우저 매트릭스를 확인하세요.
3. 대비, 색역 및 팔레트 동작 측정
| 규칙 | 값 |
|---|---|
| 밝음/어두움 경계 | L > 0.73 = 밝은 배경 → 어두운 텍스트; 그 이하에서는 밝은 텍스트가 여전히 더 높은 점수 |
| 밝기 간격 (밝은 배경) | 배경 L > 0.9일 때 전경 L < 0.35 |
| 밝기 간격 (어두운 배경) | 배경 L < 0.25일 때 전경 L > 0.9 |
| 색조 드리프트 임계값 | 팔레트 단계에서 10° 이상 퍼짐 = 눈에 띄는 드리프트 |
| APCA 본문 텍스트 | |
| APCA 비본문 텍스트 | |
| WCAG 2 일반 텍스트 | 4.5:1 AA, 7:1 AAA |
| 대비 수정 (요청 시에만) | L을 먼저 조정; 가능하면 C와 H 유지 후 렌더링된 쌍 재측정 |
일반적인 실수
| 문제 | 해결 방법 |
|---|---|
| 원시 색상이 프로젝트의 의미론적 토큰 시스템을 우회함 | 프로젝트의 기존 표기법으로 올바른 역할 토큰을 재사용하거나 추가 |
| 고립된 OKLCH 값이 hex/RGB 코드베이스에 도입됨 | 작업에 색상 시스템 마이그레이션이 포함되지 않는 한 기존 표기법 유지 |
| 색조 드리프트가 있는 HSL 팔레트 램프 | 일정한 oklch 색조로 재구축 |
| 대비 실패 (APCA를 사용하여 전경과 배경 확인) | 쌍, 측정된 Lc 및 놓친 임계값 보고; 요청 시에만 색상 변경 (L 조정, C와 H 유지) |
| 색역 확인 없는 높은 채도 | sRGB에서 L/H에 대한 최대 채도로 클램프 |
| 서로 다른 색조에서 동일한 절대 C | 일관된 선명도를 위해 동일한 C% (최대값의 백분율) 사용 |
| sRGB 폴백 없는 P3 색상 | @media (color-gamut: p3) 패턴 추가 |
| 밝은 팔레트를 기계적으로 반전시켜 만든 다크 모드 | 밝은 팔레트를 시작점으로 사용한 다음 채도와 밝기를 조정하고 모든 전경/배경 쌍 재확인 |
Tailwind v4 @theme의 Hex | oklch 값으로 변환 |
| 쉼표 구문의 알파 | 슬래시 사용: oklch(L C H / alpha) |
| 동일한 색조가 두 가지 다른 것을 의미함 (링크 색상을 장식적으로 재사용) | 하나의 색상, 하나의 의미; 두 번째 사용에는 중립 색상 부여 |
| 역할 외부에서 사용된 의미론적 토큰 (구분선을 텍스트로 사용) | 누락된 역할에 대한 토큰 추가; 값으로 빌리지 않음 |
| 하나의 뷰에 여러 색상 제어 배경 | 단일 기본 액션만 채움; 보조 액션은 중립 유지 |
| 밝은 모드에서만 확인된 팔레트 | 두 모드 모두에서 모든 전경/배경 쌍 재확인 |
검토 출력 형식
사용자가 독립형 색상 검토를 요청할 때만 이 형식을 사용하세요. better-interface가 검토를 조정하는 경우 해당 스킬에 도메인 증거와 결과를 제공하고 해당 스킬의 출력 형식, 심각도 척도, 통합 규칙, 상한 및 판정이 우선시되도록 하세요.
독립형 검토를 두 부분으로 제시하세요.
결과
모든 확인된 결과를 원칙별로 그룹화하세요. 심각도, 위치, 이전, 이후, 이유 열이 있는 마크다운 테이블을 사용하세요. 별도의 "Before:" / "After:" 줄을 사용하지 마십시오.
- 심각도:
HIGH는 콘텐츠를 읽을 수 없게 만들거나 오해의 소지가 있는 의미론적 색상을 할당합니다.MEDIUM은 눈에 띄는 테마, 색역 또는 일관성 실패를 만듭니다.LOW는 고립된 미세 조정입니다. - 위치:
path/to/file:line을 인용합니다. 아티팩트에 소스 파일이 없으면 정확한 화면과 컴포넌트를 대신 인용합니다. - 이전 / 이후: 현재 값 또는 토큰과 정확한 대체 값을 보여줍니다.
- 이유: 위반된 원칙의 이름을 명시하고, 관련된 경우 측정된 대비 또는 색역 증거를 포함합니다.
반복되는 시스템적 문제를 하나의 행으로 통합하고 영향을 받는 모든 위치를 나열하세요. 결과가 없는 원칙은 생략하세요.
| 심각도 | 위치 | 이전 | 이후 | 이유 |
|---|---|---|---|---|
| MEDIUM | src/theme.css:18 | color: #3b82f6 | color: oklch(0.623 0.188 259.815) | 새 프로젝트 색상은 OKLCH 토큰 사용 |
| MEDIUM | src/palette.ts:31 | 색조 간 동일한 절대 C | 각 색조 최대 채도의 동일한 C% | 동일한 채도 값이 색조 간에 동일하게 선명하게 나타나지 않음 |
| HIGH | src/theme.css:52 | 폴백 없는 P3 색상 | @media (color-gamut: p3) 전에 sRGB 폴백 추가 | 색상이 P3가 아닌 디스플레이에서 실패함 |
확인 및 판정
결과 이후:
- 확인: 실행된 정확한 검사와 관찰된 결과를 나열합니다. 여기에는 대비 측정, 색역 확인, 적용 가능한 경우 밝은 모드와 어두운 모드 모두 포함됩니다. 검사가 실행되지 않은 경우 여전히 검증이 필요한 내용을 명시합니다.
- 판정:
HIGH결과가 남아 있으면Block,MEDIUM또는LOW결과만 남아 있으면Needs changes, 실행 가능한 결과가 남아 있지 않을 때만Approve입니다.
결과가 없으면 테이블을 생략하고 "실행 가능한 색상 결과 없음"이라고 명시한 후 확인을 보고하고 Approve로 끝냅니다.