인터페이스를 더 정교하게 만드는 디테일
훌륭한 인터페이스는 단일 요소에서 나오는 경우가 거의 없습니다. 대부분의 경우 작은 디테일들이 모여 훌륭한 경험을 만들어냅니다. UI 코드를 작성하거나 리뷰할 때 이 원칙들을 적용하세요.
리뷰할 때는 인터페이스 속도를 늦추세요: 브라우저의 애니메이션 패널에서 모션을 10% 속도로 재생하고 모든 상태(호버, 포커스, 활성, 로딩, 빈 상태)를 살펴보세요. 10% 속도에서 어색해 보이는 것은 정상 속도에서 미묘하게 잘못된 것입니다.
프로젝트의 컴포넌트 라이브러리, 토큰, 밀도를 유지하세요. 아래 원칙에서 특정 상호작용 패턴을 규정하는 경우를 제외하고는 프로젝트의 기존 모션 언어를 따르세요.
타이포그래피(텍스트 줄바꿈, 글꼴 렌더링, 표 형식 숫자, 간격)는 better-typography 스킬이 다룹니다. 텍스트 관련 작업은 해당 스킬을 사용하세요. 접근성(히트 영역, 포커스 상태, 키보드 지원, ARIA, 모션 감소)은 better-accessibility 스킬이 다룹니다. 레이아웃 구조(그룹화, 섹션 간 간격, 중단점, 공간적 RTL)는 better-layout 스킬이 다룹니다.
빠른 참조
| 카테고리 | 사용 시점 |
|---|---|
| 표면 | 경계선 반경, 광학적 정렬, 그림자, 이미지 외곽선 |
| 애니메이션 | 중단 가능한 애니메이션, 진입/퇴장 전환, 아이콘 애니메이션, 누를 때 크기 조정, 모션 제한 |
| 아이콘 | 아이콘 선 굵기, currentColor를 통한 상태, 외곽선 vs 채우기, 크기 조정, RTL 반전 |
| 성능 | 전환 구체성, will-change 사용 |
핵심 원칙
1. 동심원 경계선 반경
외부 반경 = 내부 반경 + 패딩. 중첩된 요소의 반경이 일치하지 않으면 인터페이스가 어색하게 느껴지는 가장 흔한 원인입니다.
2. 기하학적 정렬보다 광학적 정렬
기하학적 중앙 정렬이 어색해 보일 때는 광학적으로 정렬하세요. 아이콘이 있는 버튼, 재생 삼각형, 비대칭 아이콘은 수동 조정이 필요합니다.
3. 그림자는 깊이, 테두리는 구조
깊이를 만들기 위해서만 존재하는 버튼, 카드, 컨테이너에는 투명한 box-shadow 값을 중첩하여 사용하세요. 구조나 상태를 전달하는 테두리(구분선, 레이아웃 분리선, 선택 또는 포커스 상태)는 유지하세요.
4. 중단 가능한 애니메이션
상호작용 상태 변경에는 CSS 전환을 사용하세요. 중간에 애니메이션이 중단될 수 있습니다. 키프레임은 한 번 실행되는 단계별 시퀀스에만 사용하세요.
5. 진입 애니메이션 분할 및 지연
드물게 발생하는 단계별 진입(시퀀스가 계층 구조를 전달하는 데 도움이 될 때)은 콘텐츠를 의미 있는 청크로 나누고 약 100ms 간격으로 지연시키세요. 하나의 컨테이너를 애니메이션하지 마세요. 일상적인 빈도 높은 상호작용에는 지연을 사용하지 마세요.
6. 미묘한 퇴장 애니메이션
전체 높이 대신 작은 고정 translateY를 사용하세요. 퇴장은 진입보다 부드러워야 합니다. 진입과 퇴장 전환 모두에 ease-out을 사용하세요.
7. 상황별 아이콘 애니메이션
표시 여부를 전환하는 대신 opacity, scale, blur로 아이콘을 애니메이션하세요. 정확히 다음 값을 사용하세요: scale은 0.25에서 1로, opacity는 0에서 1로, blur는 4px에서 0px로. 프로젝트의 package.json에 motion 또는 framer-motion이 있으면 해당 패키지의 가져오기 경로를 사용하고(둘 다 있을 경우 기존 인접 가져오기 경로 사용) transition: { type: "spring", duration: 0.3, bounce: 0 }를 사용하세요. bounce는 항상 0이어야 합니다. 모션 라이브러리가 설치되지 않은 경우 두 아이콘을 모두 DOM에 유지하고(하나는 절대 위치) cubic-bezier(0.2, 0, 0, 1)를 사용하는 CSS 전환으로 교차 페이드하세요. 이렇게 하면 종속성 없이 진입 및 퇴장 애니메이션을 모두 얻을 수 있습니다.
8. 이미지 외곽선
일관된 깊이를 위해 이미지에 낮은 불투명도의 미묘한 1px 외곽선을 추가하세요. 색상은 밝은 모드에서 순수 검정(oklch(0 0 0 / 0.1)), 어두운 모드에서 순수 흰색(oklch(1 0 0 / 0.1))이어야 합니다. 슬레이트, 아연 또는 어떤 색조 중립과 같은 검정에 가까운 색상은 절대 사용하지 마세요. 색조가 있는 외곽선은 아래 표면 색상을 흡수하여 이미지 가장자리에 때가 묻은 것처럼 보입니다.
9. 누를 때 크기 조정
클릭 시 미묘한 scale(0.96)은 버튼에 촉각적 피드백을 제공합니다. 항상 0.96을 사용하세요. 0.95보다 작은 값은 절대 사용하지 마세요. 그 아래 값은 과장되어 보입니다. 모션이 산만해질 경우 비활성화할 수 있는 static prop을 추가하세요.
10. 페이지 로드 시 애니메이션 건너뛰기
첫 번째 렌더링에서 진입 애니메이션이 실행되지 않도록 AnimatePresence에 initial={false}를 사용하세요. 의도적인 진입 애니메이션을 깨뜨리지 않는지 확인하세요.
11. transition: all 절대 사용 금지
항상 정확한 속성을 지정하세요: transition-property: scale, opacity. Tailwind의 transition-transform은 transform, translate, scale, rotate를 포함합니다.
12. will-change는 드물게 사용
GPU가 합성할 수 있는 속성인 transform, opacity, filter에만 사용하세요. will-change: all은 절대 사용하지 마세요. 첫 프레임에서 끊김(stutter)이 발견될 때만 추가하세요.
13. 아이콘 선 굵기를 텍스트 굵기에 맞춤
텍스트 옆에 있는 아이콘은 텍스트의 광학적 무게를 전달합니다. 일반(400) 텍스트 옆에는 1.5px 선, 세미볼드(600) 옆에는 2px 선을 사용하세요. 아이콘 세트당 하나의 선 굵기; 한 표면에서 라이브러리를 섞지 마세요.
14. 하나의 SVG, 상태별로 색상 변경
아이콘은 currentColor를 사용하고 상태(호버, 선택, 비활성화)는 별도의 에셋이 아닌 CSS 색상과 불투명도로 처리합니다. 외곽선 변형이 기본값이며, 채우기 변형은 활성 상태를 표시합니다.
15. 모션 제한
빈도 높은 상호작용에는 사용자 지정 애니메이션을 사용하지 마세요. 주의 비용이 트리거될 때마다 반복됩니다. 모션은 결코 유일한 피드백 채널이 되어서는 안 됩니다. 모든 애니메이션 상태 변경에는 정적 단서(색상, 아이콘, 레이블)도 필요합니다.
일반적인 실수
| 실수 | 수정 방법 |
|---|---|
| 밀접하게 중첩된 부모와 자식에 동일한 경계선 반경 | 외부 반경 = 내부 반경 + 패딩 계산 |
| 아이콘이 중앙에서 벗어나 보임 | 패딩으로 광학적으로 조정하거나 SVG 직접 수정 |
| 테두리를 깊이를 가장하는 데만 사용 | 투명도를 가진 중첩 box-shadow 사용; 구조적 및 상태 테두리 유지 |
| 갑작스러운 단계별 진입 또는 상황별 퇴장 | 드문 진입은 지연시키고, 문맥을 유지하는 퇴장은 미묘하게 유지 |
| 상태가 있는 아이콘 또는 토글이 페이지 로드 시 기본 상태를 애니메이션 | 해당 AnimatePresence에 initial={false} 추가; 의도적인 페이지 진입 유지 |
요소에 transition: all 사용 | 정확한 속성 지정 |
| 첫 프레임 애니메이션 끊김 | will-change: transform 추가(드물게) |
| 굵은 텍스트 옆에 가는 선 아이콘 | 선 굵기를 텍스트 굵기에 맞춤 |
| 상태별로 별도의 아이콘 에셋 | 하나의 currentColor SVG, CSS로 상태 처리 |
| 모든 곳에 채워진 아이콘 | 외곽선이 기본값, 활성 상태에서만 채우기 |
| 모든 호버 또는 키 입력 시 진입 애니메이션 | 즉각적인 피드백 또는 ≤150ms 불투명도/색상 전환 |
리뷰 출력 형식
이 형식은 사용자가 독립적인 UI 다듬기 리뷰를 요청할 때만 사용하세요. better-interface가 리뷰를 조정할 경우, 해당 스킬에 도메인 증거와 결과를 제공하고 출력 형식, 심각도 척도, 통합 규칙, 상한선 및 판정이 우선시되도록 하세요.
독립적인 리뷰는 두 부분으로 제시하세요.
결과 사항
발견된 모든 확인된 결과를 원칙별로 그룹화하세요. 심각도, 위치, 이전, 이후, 이유 열이 있는 마크다운 테이블을 사용하세요. 별도의 "이전:" / "이후:" 줄은 절대 사용하지 마세요.
- 심각도:
HIGH는 상호작용을 오도하거나 응답하지 않게 하거나 반복적으로 방해합니다.MEDIUM은 눈에 띄는 제작 또는 일관성 문제를 만듭니다.LOW는 고립된 다듬기 문제입니다. - 위치:
path/to/file:line을 인용하세요. 소스 파일이 없는 경우 정확한 화면과 컴포넌트를 대신 인용하세요. - 이전 / 이후: 현재 구현과 실행 가능한 대체 코드를 보여주세요.
- 이유: 위반된 원칙의 이름을 말하고 인터페이스에 어떤 영향을 미치는지 설명하세요.
반복되는 시스템적 문제는 한 행으로 통합하고 영향을 받는 모든 위치를 나열하세요. 결과가 없는 원칙은 생략하세요.
예시
동심원 경계선 반경
| 심각도 | 위치 | 이전 | 이후 | 이유 |
|---|---|---|---|---|
| LOW | src/Card.tsx:28 | 카드에 rounded-xl + 내부 버튼에 rounded-xl (p-2) | 카드에 rounded-2xl (8 + 8 = 16), 내부 버튼에 rounded-lg | 중첩된 모서리는 동심원이어야 함 |
| LOW | src/card.css:11 | 두 중첩 표면 모두 border-radius: 16px | 외부 24px, 내부 16px, 패딩 8px | 동일한 중첩 반경은 내부 표면이 움푹 들어간 것처럼 보이게 함 |
누를 때 크기 조정
| 심각도 | 위치 | 이전 | 이후 | 이유 |
|---|---|---|---|---|
| LOW | src/Button.tsx:19 | <button className="..."> | active:scale-[0.96] transition-transform 추가 | 누름 피드백으로 컨트롤이 반응적으로 느껴짐 |
| MEDIUM | src/button.css:24 | 누를 때 scale(0.9) | scale(0.96)으로 상향 | 0.95 아래 값은 과장되어 보임 |
검증 및 판정
결과 사항 이후:
- 검증: 실행된 정확한 검사와 관찰된 결과를 나열하세요. 모든 관련 상태를 살펴보고 애니메이션이 포함된 경우 10% 속도로 모션을 검사하세요. 검사가 실행되지 않은 경우 아직 검증이 필요한 내용을 명시하세요.
- 판정:
HIGH결과가 남아 있으면Block,MEDIUM또는LOW결과만 남아 있으면Needs changes, 실행 가능한 결과가 없을 때만Approve를 반환하세요.
결과가 없는 경우 테이블을 생략하고 "No actionable UI-polish findings"라고 명시한 후 검증을 보고하고 Approve로 끝내세요.