개발
2026.10.02 · 4분
Tailwind v4 에서 focus:outline-none 을 붙였는데 초점 테두리가 그대로 그려졌다. 원인은 명시도가 아니라 cascade layer 였다. globals.css 에 레이어 없이 쓴 :focus-visible 규칙은 @layer utilities 안의 유틸리티를 명시도와 상관없이 이긴다. 그래서 예외는 클래스가 아니라 globals.css 에 규칙으로 둬야 했다.
같은 날 머리글 링크의 누르는 영역을 20px 에서 44px 로 키웠다. 레이아웃 높이를 지키려다 한 번 틀린 이야기도 같이 적는다.
2026-10-02 에 이 블로그를 검수하면서 두 가지가 나왔다.
건너뛰기 링크는 흔한 모양으로 만들었다. 평소에는 sr-only 로 숨기고 초점을 받으면 보인다. 목적지는 <main id="main" tabIndex={-1}> 이다.
tabindex="-1" 을 단 이유는 MDN 이 적은 그대로다.
A negative value (the exact negative value doesn't actually matter, usually tabindex="-1") means that the element is not reachable via sequential keyboard navigation.
Tab 순서에는 끼지 않으면서 건너뛰기 링크를 누르면 초점을 받는다. 그래야 다음 Tab 이 머리글이 아니라 본문 안의 첫 링크로 간다.
전역 규칙이 레이어 밖에 있었기 때문이다. 초점이 <main> 으로 옮겨 가면 본문 전체에 초록 테두리가 그려졌다. 조작하는 요소가 아니니 지우려고 focus:outline-none 을 붙였다. 다시 재 보니 그대로였다.
Playwright 로 Tab 한 번, Enter 한 번을 누른 뒤 <main> 의 outline-style 을 읽었다. solid 였다.
전역 규칙은 이렇다.
:focus-visible {
outline: 2px solid var(--mark);
outline-offset: 2px;
}
명시도만 보면 이상하다. :focus-visible 은 의사 클래스 하나라 (0,1,0) 이고, Tailwind 가 만드는 .focus\:outline-none:focus 는 클래스와 의사 클래스라 (0,2,0) 이다. 클래스 쪽이 이겨야 한다.
그런데 이 싸움은 명시도까지 가지 않는다. MDN 의 cascade layer 학습 문서가 이렇게 적는다.
Normal unlayered declarations take precedence over normal layered declarations even if the unlayered styles have a lower specificity and come first in the order of appearance.
Tailwind v4 는 유틸리티를 네이티브 레이어에 넣는다. 공식 문서의 문장이다.
Custom utilities are automatically inserted into the utilities layer along with all of the built-in utilities in the framework.
정리하면 이렇다. focus:outline-none 은 utilities 레이어 안에 있고 globals.css 의 :focus-visible 은 어느 레이어에도 없다. 레이어 밖 일반 선언이 이기므로 명시도가 낮아도 전역 규칙이 이긴다.
예외를 globals.css 에, 전역 규칙과 같은 레이어 밖에 두었다.
[tabindex='-1']:focus-visible {
outline: none;
}
같은 레이어 밖이니 이번에는 명시도와 순서로 겨룬다. 속성 선택자와 의사 클래스라 (0,2,0) 이고 뒤에 나오므로 이긴다. 다시 재니 outline-style 이 none 이 됐다. 다음 Tab 은 본문 안의 코드 블록으로 갔다.
다른 길도 있었다.
@layer base 안으로 옮긴다. 그러면 유틸리티가 이긴다. 다만 레이어 밖에 있던 전역 규칙 전체의 우선순위가 바뀐다. 이번 일보다 범위가 크다.focus:outline-none! 처럼 !important 를 붙인다. 동작은 한다. MDN @layer 문서대로 !important 끼리는 순서가 뒤집혀 레이어 안이 이기기 때문이다. 하지만 다음에 이 규칙을 덮을 사람은 더 센 !important 를 찾아야 한다.[의견] 처음 만들 때라면 전역 접근성 규칙을 @layer base 에 두는 편이 덜 놀랍다. 이미 레이어 밖에 있다면 예외도 같은 자리에 두는 쪽이 고치는 범위가 작다.
하나 더 있다. Tailwind v3 에서 v4 로 오며 outline-none 의 뜻이 바뀌었다. v3 의 outline-none 은 v4 에서 outline-hidden 이 됐고 v4 의 outline-none 은 실제로 outline-style: none 을 준다. 그러니 이번 실패는 클래스 이름 탓이 아니었다. 클래스는 맞게 골랐고 레이어에서 졌다.
AA 등급은 24px 다. 44px 는 AAA 기준이다. 「WCAG 가 터치 영역 44px 를 요구한다」는 말을 자주 보는데, 2.5.8 Target Size (Minimum) 의 문장은 이렇다.
The size of the target for pointer inputs is at least 24 by 24 CSS pixels, except when:
44px 는 2.5.5 Target Size (Enhanced) 쪽이다.
The size of the target for pointer inputs is at least 44 by 44 CSS pixels except when:
이 블로그의 머리글 링크는 36×20px 였는데도 2.5.8 의 간격 예외로 통과했다. 대상이 24px 보다 작아도 대상마다 지름 24px 원을 그렸을 때 원끼리 겹치지 않으면 된다. 링크 사이가 16px 라 그 조건에 맞았다. 그래도 44px 로 키운 것은 등급을 맞추려는 게 아니라 엄지로 누르기 쉽게 하려는 것이었다.
링크에 위아래 여백을 주고, 그만큼 바깥 여백을 줄였다. 글자 크기와 색, 링크 사이 간격은 그대로다.
py-3 을 더해 높이 20px → 44pxpy-4 → py-2.5-mx-2 px-2. 링크 사이 16px 안으로만 8px 씩 넓혀 이웃 링크의 영역과 겹치지 않는다.처음에는 로고에도 py-2.5 를 줬다. 390px 와 1280px 에서는 머리글 높이가 그대로였는데 320px 에서 92px 가 108px 로 늘었다. 320px 에서는 로고와 메뉴가 두 줄로 갈리는데, 두 줄일 때는 로고에 준 여백이 그대로 더해졌다. 로고 여백을 빼고 머리글 여백으로 옮겨 맞췄다.
세로로 음수 여백(py-3 -my-3)을 쓰면 높이를 아예 안 건드릴 수 있다. 그런데 두 줄로 갈리면 키운 영역이 위 줄의 로고 쪽으로 겹친다. 메뉴를 누르려다 로고를 누르게 된다. 그래서 쓰지 않았다.
재는 방법은 단순하다. 세 폭(320·390·1280px)에서 머리글·꼬리말 링크의 getBoundingClientRect() 를 모아 높이와 서로 겹치는지를 본다. 결과는 링크 높이 44px, 겹침 0, 가로 넘침 0 이었다.
아니었다. 확인하는 데 대조군이 필요했다. 소개 화면이 1280px 에서 CLS 0.007~0.015 로 나와 처음에는 내 변경을 의심했다. 그래서 바뀌기 전인 운영 화면을 같은 방법으로 쟀다. 같은 요소들(목록, 소제목, 문단)에서 같은 값이 나왔다. 폰트가 바뀌면서 줄이 다시 흐르는 원래 있던 현상이었다.
막지 않은 상태에서도 같은 결과가 나오는지 먼저 보는 습관은 죽인 줄 알았던 서버가 옛 빌드를 보여주던 일에서 얻었다. 이번에도 그 덕에 엉뚱한 곳을 고치지 않았다.
!important 가 아닐 때).이 글은 AI 가 조사·초안을 작성하고 사람이 검수한 뒤 발행했습니다. 사실관계는 아래 출처에서 확인할 수 있습니다.