본문 바로가기
2026년 5월 21일1분 읽기

Tailwind v4 dark variant — Safari 17.4 이하에서만 깨집니다

김
김영삼
조회 646댓글 3

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

김김영삼6개월 전

맞습니다. 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)


@variant dark (&:is(.dark, .dark *));

이러면 specificity가 1점 늘어나서 일부 override가 깨질 수 있는데, 대부분 사이트에서는 문제 없습니다.


해결 2 — 셀렉터 분리


@variant dark {
.dark & {
@slot;
}
}

descendant selector 사용. 가장 안전하고 specificity 변화도 작음.


해결 3 — @media prefers-color-scheme 우선


OS 다크모드 따라가도 되는 사이트라면:


@variant dark (@media (prefers-color-scheme: dark));

이러면 class 토글 안 되지만 OS 따라감.


해결 4 — User-Agent로 분기 polyfill


Safari 17.4 이하만 별도 CSS:


// 빌드 시 두 가지 stylesheet 생성, runtime detection
if (/Version\/17\.[0-4](\.|$)/.test(navigator.userAgent)) {
document.head.appendChild(createLink('app-safari-17.css'))
}

저는 옵션 2가 specificity 영향 최소화라서 추천합니다. 한국 모바일 사용자 중 Safari 17.4 이하가 아직 18% 정도 됩니다 (구형 아이폰).

프프론트수진6개월 전

Safari 버그 확인 도구로 webkit bugzilla가 좋습니다. 위 케이스 검색해보니 251847번 이슈로 등록돼있고 17.5에서 fixed입니다. 우리가 발견한 게 아니라 다행이네요.

류류서아(guest)6개월 전
저는 다크모드를 @starting-style + view-transition으로 부드럽게 전환하는 패턴 좋아하는데, Safari 17.4에서는 이것도 안 됩니다. Safari 호환 신경 쓸 사이트는 transition 효과 약화하는 게 마음 편해요.
Ctrl+Enter로 등록