light-dark() 하나로 두 테마를 적으며 만난 세 가지
테마 블록마다 따로 적은 색 때문에 옛 브랜드색이 되살아났습니다. light-dark()로 두 테마의 색을 한곳에 모은 뒤, 퍼센트 자리에 넣어 배경이 사라진 일과 빌드가 함수를 변수로 바꿔 테마 전환이 멈춘 일을 차례로 겪었습니다.
들어가며
물타기 계산기의 디자인 목업에서 브랜드색을 확인하다가 주석과 값이 다른 줄을 발견했습니다.
/* Aurora 는 #7040D9 */
--brand: #6F3DE0;
설명에 적힌 색은 새 보라였지만, 화면을 그리는 값은 옛 보라였습니다. 이 일을 계기로 라이트와 다크의 색을 light-dark() 한 줄에 모았습니다. 그 뒤 다른 두 화면에서 같은 함수 때문에 한 번씩 더 걸렸습니다. 세 번을 차례로 적습니다.
하나 — 같은 색을 고칠 곳이 다섯 군데였다
목업에는 시스템 설정과 사용자의 선택에 따라 적용되는 색 정의가 각각 있었습니다.
| 위치 | 적용되는 경우 |
|---|---|
:root | 기본 라이트 테마 |
@media (prefers-color-scheme: dark) | 시스템이 다크일 때 |
[data-theme="dark"] | 사용자가 다크를 고를 때 |
[data-theme="light"] | 사용자가 라이트를 고를 때 |
.phone 스킨 3개 | 목업 안의 휴대전화 화면 |
이 중 한 곳에 #6F3DE0이 남아 뒤에서 새 색을 덮고 있었습니다. 같은 라이트 화면이라도 시스템 기본으로 들어왔는지 사용자가 직접 골랐는지에 따라 다른 블록을 읽었습니다.
light-dark()에 첫 번째로 라이트 색, 두 번째로 다크 색을 넣었습니다.
:root {
color-scheme: light dark;
--token-bg: light-dark(#F8F6FC, #110D19);
--token-text: light-dark(#21182D, #FAF7FF);
--token-primary: light-dark(#7040D9, #986CF4);
}
:root[data-theme="dark"] { color-scheme: dark; }
:root[data-theme="light"] { color-scheme: light; }
어느 값을 쓸지는 요소에 적용된 color-scheme이 정합니다. 수동 선택이 없으면 시스템 설정을, data-theme이 있으면 그 선택을 따릅니다. 색을 고칠 때는 두 값을 한 줄에서 함께 봅니다. 화면에서 짧은 이름이 필요하면 값을 옮겨 적지 않고 --bg: var(--token-bg)처럼 가리키게 했습니다.
color-scheme은 body가 아니라 :root에 둡니다. 이 속성은 색상 함수 외에도 브라우저가 그리는 스크롤바와 폼 컨트롤에 영향을 주고, 루트에 선언해야 페이지 캔버스와 뷰포트 스크롤바까지 따라옵니다(CSS Color Adjustment 명세). 작업 당시 확인한 지원 시작 버전은 Chrome 123, Safari 17.5, Firefox 120이었습니다.
둘 — 퍼센트 자리에 넣었더니 배경이 사라졌다
2026년 9월 2일, Emoticon Studio 목업에서 배지와 카드의 옅은 배경이 보이지 않았습니다. 토큰은 이렇게 적혀 있었습니다.
--wash: color-mix(in srgb, var(--text) light-dark(8%, 12%), transparent);
라이트에서는 글자색을 8%, 다크에서는 12% 섞으려 했습니다. 테마에 따라 비율만 바뀌니 그 자리에 light-dark()를 넣은 것입니다.
하지만 색상 값에 쓰는 light-dark()는 두 색 중 하나를 고르는 함수입니다(CSS Color 5). 8%와 12%는 색이 아니므로 인자도, 결과를 쓸 자리도 맞지 않았습니다. --wash라는 변수는 있어도 배경색으로 해석할 수 없는 값이 됐습니다.
비율을 고르는 대신 색을 먼저 만들고 그 둘 중에서 골랐습니다.
--wash: light-dark(
color-mix(in srgb, var(--text) 8%, transparent),
color-mix(in srgb, var(--text) 12%, transparent)
);
변수 이름이 있다고 끝이 아니었습니다. 개발자 도구의 Computed에서 실제 background-color까지 봐야 잡히는 문제였습니다.

셋 — color-scheme을 바꿔도 배경이 그대로였다
이틀 뒤, 이모티콘 작업 조회 화면에서 밝은 테마를 골랐는데 배경은 어두운 채였습니다. 스크롤바와 폼만 바뀌었습니다. 스크립트는 테마를 고르면 루트의 style.colorScheme을 바꾸고 있었고, 토큰은 위의 방식대로 적혀 있었습니다. 소스만 보면 맞았습니다.
빌드 결과를 열었더니 light-dark()가 하나도 없었습니다. 이 프로젝트의 Vite 8 빌드에서 Lightning CSS가 함수를 변수로 바꿔 놓았습니다.
--bg: var(--lightningcss-light, #f8f8f8)
var(--lightningcss-dark, #100d18);
출력된 CSS에서 이 변수를 바꾸는 조건은 시스템 테마 미디어 쿼리와 :root[data-theme=…] 선택자였습니다. 자바스크립트가 color-scheme만 바꿔서는 그 선택자가 새로 걸리지 않았습니다. Lightning CSS 문서는 대상 브라우저가 light-dark()를 지원하지 않을 때 이렇게 변수 폴백으로 바꾼다고 설명합니다.
토큰을 다시 두 벌로 나눌 필요는 없었습니다. 테마 선택을 CSS에 전달하는 방식만 data-theme으로 맞췄습니다.
if (next === 'system') {
delete document.documentElement.dataset.theme
} else {
document.documentElement.dataset.theme = next
}
시스템 설정을 따를 때는 속성을 지웁니다. 시스템 모드를 그 순간의 밝음·어두움으로 바꿔 저장하면 이후 운영체제의 테마 변경을 따라가지 못하기 때문입니다.
마치며
세 번 모두 소스에는 문제가 없어 보였습니다. 첫째는 뒤에서 덮는 블록이, 둘째는 함수가 받는 값의 종류가, 셋째는 빌드가 바꿔 놓은 출력이 원인이었습니다. 그 뒤로 테마 색을 고치면 소스가 아니라 브라우저가 계산한 값과 빌드 결과를 먼저 엽니다.