Tailwind v4로 업그레이드 후 다크모드가 일부 사용자에게서 안 보입니다. 조사해보니 Safari 17.4 이하에서 깨집니다. 17.5 이상은 정상.
설정:
/* app.css */
@import "tailwindcss";
@variant dark (&:where(.dark, .dark *));
HTML에는 <html class="dark"> 토글하고 있습니다. Chrome/Edge/Firefox는 잘 동작. Safari 17.4에서만 다크 클래스가 들어가도 dark: prefix가 적용 안 됩니다.
:where() 안에서 다른 element 셀렉터 조합이 Safari 17.4의 CSS parser 버그라는 얘기를 들었는데 정확한 우회 방법을 모르겠습니다.
댓글 3
맞습니다. Safari 17.4 이하의 :where() 파싱 버그입니다. 17.5에서 패치됐어요. 우회 패턴 정리.
원인
Safari 17.4의 CSS parser가
:where(.dark, .dark *)같이 같은 셀렉터에 자기 자신 + descendant를 OR로 묶을 때 specificity 계산을 잘못합니다. tailwindcss v4의 @variant dark가 정확히 이 패턴을 씁니다.해결 1 — :where()를 :is()로 (specificity는 올라가지만 동작은 OK)
이러면 specificity가 1점 늘어나서 일부 override가 깨질 수 있는데, 대부분 사이트에서는 문제 없습니다.
해결 2 — 셀렉터 분리
descendant selector 사용. 가장 안전하고 specificity 변화도 작음.
해결 3 — @media prefers-color-scheme 우선
OS 다크모드 따라가도 되는 사이트라면:
이러면 class 토글 안 되지만 OS 따라감.
해결 4 — User-Agent로 분기 polyfill
Safari 17.4 이하만 별도 CSS:
저는 옵션 2가 specificity 영향 최소화라서 추천합니다. 한국 모바일 사용자 중 Safari 17.4 이하가 아직 18% 정도 됩니다 (구형 아이폰).
Safari 버그 확인 도구로 webkit bugzilla가 좋습니다. 위 케이스 검색해보니 251847번 이슈로 등록돼있고 17.5에서 fixed입니다. 우리가 발견한 게 아니라 다행이네요.