Seenry 모션
모션은 변화를 설명하기 위해 존재합니다: 요소가 어디서 왔는지, 입력이 무엇을 했는지, 인터페이스가 현재 어떤 상태인지. 아래 순서대로 모든 애니메이션을 구축하세요. 1단계와 2단계는 코드를 전혀 작성할지 말지를 결정합니다.
판단을 내리고 한 줄로 명시하세요. 여러 모션 옵션을 제시하지 마세요. 프로젝트의 기존 모션 토큰과 컴포넌트를 확장하고, 별도의 세트를 추가하지 마세요.
구축 순서
1. 애니메이션을 적용해야 할까요? 빈도에 따라 결정합니다.
| 사람들이 보는 빈도 | 결정 |
|---|---|
| 하루 100회 이상 (명령 메뉴, 키보드 단축키, 화살표로 목록 탐색) | 애니메이션 없음. 즉시. |
| 하루 수십 회 (호버, 탭, 토글) | 불투명도와 색상만 150ms 이하, 또는 없음 |
| 가끔 (메뉴, 다이얼로그, 시트, 토스트) | 아래 표의 표준 모션 |
| 드물게 (온보딩, 첫 성공, 빈 상태에서 가득 찬 순간) | 개성을 위한 여유 |
키보드로 트리거된 작업은 절대 애니메이션을 기다리지 않습니다. 게이트가 '아니오'라고 말하면 그렇게 말하고 즉시 상태를 변경하세요.
2. 목적을 한 단어로 명명하세요: 피드백, 방향(어디서 왔거나 갔는지), 상태, 연속성(갑작스러운 점프 방지), 설명(마케팅 및 온보딩 전용), 또는 즐거움(드문 순간 전용). 목적이 없으면 애니메이션도 없습니다. 사람들이 읽고 있는 데이터는 스타일을 위해 움직이지 않습니다.
3. 작동하는 가장 저렴한 도구를 선택하세요.
| 필요 | 도구 |
|---|---|
| 호버, 누름, 색상, 클래스 또는 속성 토글 | CSS 전환 |
마운트 시 진입, display: none 전 종료, 네이티브 <dialog> 및 popover | CSS 전환 + @starting-style + allow-discrete |
auto 높이 | interpolate-size: allow-keywords, 또는 그리드 0fr → 1fr 트랙 |
| 경로 변경, 목록 → 상세, 형태 변경 표시기 | View Transitions API |
| 스크롤 연결 효과 | animation-timeline: view() / scroll() |
| 프로그래밍 가능, 취소 가능, 라이브러리 없음 | Web Animations (element.animate) |
| 속도가 있는 스프링, 레이아웃 애니메이션, 제스처, React의 존재 | Motion (motion.dev) |
| 전체 컴포넌트 (토스트, 서랍, 명령 메뉴, 선택) | 유지 관리되는 라이브러리, 라이브러리 참조 |
4. 속성을 선택하세요. translate, scale, rotate, opacity, clip-path, filter만 사용하세요. 절대 scale(0)에서 진입하지 마세요: 0.95–0.97과 불투명도 0에서 시작하세요. 팝오버는 트리거에서 배율을 조정합니다(transform-origin은 트리거 쪽에); 다이얼로그는 중앙에서 배율을 조정합니다. 백분율 변환(translate: 0 100%)은 요소 자체 크기만큼 이동합니다.
5. 곡선과 지속 시간, 또는 스프링을 선택하세요.
| 모션 | 지속 시간 | 이징 |
|---|---|---|
| 누름 피드백 | 100–160ms | --ease-out |
| 툴팁, 작은 팝오버 | 120–200ms | --ease-out |
| 메뉴, 드롭다운, 선택 | 150–250ms | --ease-out |
| 다이얼로그 | 200–250ms | --ease-out |
| 시트, 서랍 | 350–500ms | --ease-drawer |
| 화면을 가로질러 이동하는 요소, 형태 변경 | 250–400ms | --ease-in-out |
| 호버 시 색상, 배경, 테두리 | 150ms | ease |
| 진행률, 마키, 길게 눌러 확인 채우기 | 작업 시간만큼 | linear |
--ease-out: cubic-bezier(0.23, 1, 0.32, 1), --ease-in-out: cubic-bezier(0.77, 0, 0.175, 1), --ease-drawer: cubic-bezier(0.32, 0.72, 0, 1). 인터페이스 모션에서 절대 ease-in을 사용하지 마세요: 사람들이 보고 있는 순간을 정확히 지연시킵니다. 제품 UI는 300ms 미만을 선호하세요; 더 긴 시트 이동에는 이유가 필요합니다. 종료는 종종 진입보다 약 20~30% 더 빠릅니다. 단, 직접 조작이나 공간 관계를 유지하는 경우 동일한 시간이 필요할 수 있습니다. 사용자가 드래그, 튕기기 또는 중간에 되돌릴 수 있는 모든 것에는 스프링을 사용하세요: Motion {type: "spring", duration: 0.5, bounce: 0.2} (제품 UI의 경우 바운스 0, 장난스러운 경우 ≤0.3), 또는 레시피의 CSS linear() 스프링.
6. 중단 및 종료를 계획하세요. 가역적인 속성 변경에는 CSS 전환을 선호하세요. 현재 값에서 다시 대상으로 지정하기 때문입니다. 지오메트리나 안무에 WAAPI가 필요한 경우, 현재 렌더링된 상태를 캡처하고, 소유한 애니메이션을 취소하거나 다시 대상으로 지정하며, 오래된 완료를 보호하세요. 두 번째 입력은 이전 요청 뒤에 대기하지 않고 역전시키거나 대체합니다. 새 논리적 상태를 즉시 게시하세요. 별도의 프레젠테이션 상태는 종료를 유지할 수 있습니다.
중단된 변경을 개선하세요. 컴포넌트에 적합한 경우 다음 검사를 사용하세요. 이는 디자인 휴리스틱이며, 보장된 심사 점수가 아닙니다. 진입 및 종료 중에 50–150ms 간격을 포함하여 반복 입력을 시도하세요. 타이밍을 주장할 때 실제 타이밍을 기록하세요.
- 연속성과 의미를 유지하세요. 관련 탭, 필터 또는 상태 표시기는 하나의 그리드 셀을 공유할 수 있습니다(
display:grid,grid-area:1/1) 그리고 불투명도 또는 작은 변환을 전환합니다. 비활성 콘텐츠를 포커스 순서 및 접근성 트리에서 제외하세요. 마운트되었다고 해서 상호작용 가능한 것은 아닙니다. 빠른 나가는 단계(약 65–90ms)와 들어오는 120–160ms는 시작점일 수 있으며, 필수 레시피는 아닙니다. 현재 전환이 허용할 때만 마운트 해제하거나 숨기세요. 오래된 완료는 절대 최신 상태를 숨겨서는 안 됩니다. 명시적으로 취소 가능한 WAAPI와 보호된 네이티브 다이얼로그 종료는 유효한 대안입니다. - 결과를 이해할 수 있게 유지하세요. 우발적인 빈 간격이나 읽을 수 없는 경쟁 텍스트를 피하세요. 콘텐츠에 따라 오버랩, 짧은 크로스페이드 또는 즉시 대체를 선택하세요. 전체 레이블 엔드포인트 페이드는 텍스트가 아트워크를 통해 이동하는 것보다 안전할 수 있습니다. 모션을 사용할 수 없거나 축소된 경우 적절한 정적 큐를 유지하세요. 불투명도 임계값을 증거로 사용하지 말고 실제 가독성을 검사하세요.
- 이동하는 것은 하나의 사본. 제목, 아바타 또는 커버가 새 위치로 이동할 때, 보이는 중복 페인트를 피하세요. 여행자가 도착할 때까지 대상을 숨긴 다음 임시 복사본을 폐기하세요. 아트워크와 이동하는 껍질에 대해 텍스트를 추적하세요. 클리핑되지 않은 엔드포인트는 읽을 수 있는 경로를 증명하지 않습니다.
- 레이블은 결과와 일치해야 합니다. "Mark paid"가 "Paid"가 되는 것과 같은 레이블은 결과와 동일한 허용된 애플리케이션 상태를 따릅니다. 필요할 때 공간을 예약하고 오래된 텍스트나 포커스 가능한 중복 레이블을 방지하세요. 단순히 장식을 완료하기 위해 실제 성공 상태를 지연시키지 마세요.
- 시퀀스는 취소될 수 있습니다. 타이핑 데모, 단계적 공개 및 재생은 보류 중인 단계에 대한 소유자를 공유합니다. 일시 중지, 역전 및 새 입력은 오래된 작업을 취소하고 현재 상태에서 보이는 모션을 다시 대상으로 지정합니다. 오래된 타임아웃은 일시 중지된 시퀀스를 재개하거나 최신 콘텐츠를 덮어쓰지 않아야 합니다.
- 완료된 애니메이션을 해제하세요. CSS 또는 커밋된 스타일을 통해 안정된 상태를 설정한 다음, 적절할 때 유한한 소유 WAAPI 애니메이션을 해제하세요.
fill:forwards는 이후 상태 변경을 계속 덮어쓰지 않아야 합니다. 상호 작용이 안정된 후 예상치 못한 애니메이션을 확인하고, 의도적인 진행 중 로딩 표시기가 작업이 끝날 때까지 허용됩니다. - 각 이동은 관계를 설명합니다. 메뉴는 트리거에서 자라나고, 패널은 가장자리에서 자라나며, 관련 콘텐츠는 탐색과 일관되게 이동합니다. 위의 지속 시간 범위를 시작점으로 사용하세요. 인지된 응답을 즉각적으로 유지하고 더 긴 이동을 정당화하세요. 고정된 지속 시간을 품질 증거로 취급하지 말고 중단 및 축소 모션을 테스트하세요.
9점 달성. 모션 심사에서 7점은 정확하지만 일반적이고, 8점은 분명히 프리미엄이며, 9점은 Apple 또는 Linear 수준의 차별화된 점수입니다. 라운드는 같은 몇 가지 이유로 7–8에서 정체됩니다. 실행을 소비하기 전에 모두 처리하세요:
- 한 번에 하나의 컴포넌트. 각 컴포넌트를
--labels "<Row>"로 단독으로 심사하여 9점을 받을 때까지 진행하고, 각각의 최상의 버전을 유지하세요. 카탈로그의 전체 점수는 가장 약한 행을 따르므로, 한 번에 많은 행을 패치하는 것은 절대 움직이지 않으며, 행을 낮추는 변경은 심사자가 제안했더라도 되돌려집니다. - 모든 수정 사항을 적용하세요. 핵심 사항만이 아닙니다. 반복되는 작은 항목(호버, 누름 및 닫기 제어 피드백)은 라운드마다
states를 7로 유지합니다.--prev <last motion.json>은 상승하지 않은 기준과 다시 수정하도록 요청된 상호 작용을 나열합니다.check.mjs가 자동으로 전달합니다. - 수정 후 다시 나타나는 문제는 구조적입니다. 재타이밍은 교차하는 경로를 고칠 수 없습니다. 공유 요소는 상태 간에 상대적 배열을 유지합니다: 제목이 커버 아래에 있으면 상세 보기에서도 아래에 유지되므로, 둘 중 하나가 다른 것을 통과하지 않습니다.
- 빈 프레임 없음. 모든 촬영된 순간(30–320ms)에 변경된 영역은 실제 콘텐츠를 표시합니다. 껍질은 성장하면서 내용물을 운반합니다. 스트리밍 응답은 첫 단어에서 자랍니다. 빈 답변 상자나 기다렸다가 사라지는 스켈레톤을 절대 표시하지 마세요.
- 컴포넌트당 하나의 정교한 아이디어. 지속되는 것은 이동하고 새로운 것은 원인에서 탄생합니다. 페이드, 4px 변환 및 레이블 교체는 7점을 받습니다.
- 열린 곳에서 닫으세요. 컨트롤에서 열리는 표면은 같은 지점에서 닫힙니다: 컨트롤이 닫힘(또는 그 자리에서 대체)이 되므로 손이 이동하지 않습니다. 같은 색상을 유지할 필요는 없습니다. 위치와 크기를 유지합니다.
- 단일 실행은 점수가 아닙니다. 한 번의 심사 실행(그 자체로 3개의 중앙값)은 변경되지 않은 코드에서 1점 이동합니다. 두 번의 개별 실행이 모두 9점에 도달할 때만 9점을 수락하고, 동일한 실행 횟수로 버전을 비교하세요.
7. 축소 모션 및 입력 게이팅과 함께 제공하세요. prefers-reduced-motion: reduce에서 움직임, 시차, 블러 및 루프를 제거하세요. 이해를 돕는 짧은 불투명도 변경은 유지하세요. @media (hover: hover) and (pointer: fine)으로 호버 모션을 게이팅하세요. 모든 애니메이션 상태 변경은 모션이 실행되지 않을 때를 위한 정적 큐(레이블, 아이콘, 색상)도 남깁니다.
레시피
레시피에서 누름 피드백, 메뉴 및 팝오버, 툴팁, 다이얼로그, 시트, 토스트, 아코디언, 계단식 진입, 탭 표시기, 페이지 및 공유 요소 전환, 스크롤 공개, 아이콘 교체, 숫자 변경, 길게 눌러 확인, 드래그하여 닫기(속도 투영 및 고무 밴딩 포함), 크로스페이드 마스킹, 테마 전환 및 첫 렌더링 억제에 대해 시작하세요. 네이티브 CSS 레시피는 패키지 테스트에서 Chromium에서 실행됩니다.
실행 가능한 에셋
| 요청된 변경 | 집중 경로 |
|---|---|
| 액션 메뉴 또는 짧은 상태 레이블 | 원본 액션 메뉴, 상태 전환 및 제품 전환. 메뉴가 열리고 닫히면서 애니메이션되도록 요청된 경우, 닫히는 단계 동안 표면을 유지하세요. 닫힘 시 조건부 마운트 해제는 해당 단계를 건너뜁니다. 상태 전환의 경우 예약된 슬롯에서 텍스트를 이동하세요. 단순한 텍스트 대체 또는 점 색상 변경만으로는 불완전합니다. 애플리케이션이 실제 작업을 소유합니다. |
| 흐름 내 공개 또는 변경되는 지오메트리 | 원본 확장 카드, 지오메트리 헬퍼 및 표면 패턴. 포커스를 유지하고 현재 지오메트리에서 다시 대상으로 지정하세요. |
| 집중 모달 작업 | 원본 모달 표면 및 표면 패턴. 최상위 계층 및 포커스 동작을 위해 네이티브 다이얼로그를 사용하세요. 닫기 전에 종료를 완료하고, 역전이 보류 중인 닫기를 취소하도록 하세요. |
| 숫자 또는 아이콘 변경 | 숫자 전환 및 어댑터. 작은 정수 카운트의 경우 원본 count-pop 헬퍼가 숫자 의미를 재구성하는 것보다 선호됩니다. 하나의 실제 접근 가능한 값을 유지하세요. 모든 숫자를 숨기고 일반 <strong>에 aria-label을 넣지 마세요. 숫자 전환에는 위치별 모션이 필요합니다. 단위를 고정하세요. |
| 실시간 음성 입력 또는 출력 | 원본 음성 존재는 애플리케이션 소유 상태와 정규화된 오디오 레벨을 허용합니다. 컨트롤과 알림을 DOM에 유지하세요. 생성된 데모 신호는 마이크 활동이 아닙니다. |
| 로딩 또는 프로세스 존재 | 원본 신호 필드, 경계 추적 및 로딩 패턴. 애니메이션 시간은 진행률이 아닙니다. |
| 디코딩된 이미지 또는 표현 재료 | 원본 이미지 공개, 반사 고체 및 림 표면, 포인터 기울기, 표면 효과 및 표현 효과. 대체가 로드되는 동안 유용한 콘텐츠를 유지하세요. 재료에 목적이 있는 경우에만 반사 및 기울기를 사용하세요. |
| 새 대화형 컴포넌트 디자인 (요약, 상태 그래프, 모션 점수, 입력 계약, 체크리스트) | 상호 작용 제작 |
| 토스트 또는 배너 스택 | 피드백 패턴 및 원본 알림 리듀서. 활성 상태에서 종료 전에 오버플로를 제거하세요. 세 항목 스택에서 네 번째 이벤트를 테스트하세요. |
| 가끔 완료된 이정표 | 원본 확인 버스트. 먼저 애플리케이션 상태에 성공을 기록한 다음, 유한한 장식을 재생하세요. 안정된 결과는 지워진 후에도 계속 표시되어야 합니다. |
| 선택된 탭 또는 정렬된 페이지 변경 | 공유 하이라이트를 위한 원본 선택 표면 및 관련 뷰를 위한 방향성 스테이지. 애플리케이션이 선택, 패널, 경로 및 기록을 소유합니다. 다른 구조에는 탐색 패턴을 사용하세요. |
| 스크롤 또는 조정된 시스템 | 스크롤 안무, 작업 점수, 시스템 안무 및 모션 인덱스. |
이 변경에 필요한 가이드와 헬퍼만 선택하세요. 번들된 원본 에셋은 재사용 가능한 시작점이며, 명명된 소스 컴포넌트에 대한 자동 대체 또는 그에 대한 충실도 증거가 아닙니다. 복사된 타사 런타임과 함께 라이선스를 유지하세요. 원본 Seenry 에셋은 저장소의 MIT 라이선스를 사용합니다.
절대 제공하지 마세요
| 절대 | 대신 |
|---|---|
| 하루 100회 이상 또는 키보드 구동 작업에 대한 애니메이션 | 즉시 변경 |
transition: all | 속성 이름 지정 |
... (원문에서 잘린 부분)