모션 성능 수정 (fixing-motion-performance)
선택적 읽기 규칙
다음부터 시작하세요:
references/senior-master-standard.mdreferences/usage-routing.mdreferences/quality-checklist.md
그런 다음 사용자의 실제 작업과 일치하는 상속된 문서, 스크립트, 에셋 또는 예제만 불러오세요.
애니메이션 성능 문제를 수정합니다.
사용 방법
-
/fixing-motion-performance이 대화에서 모든 UI 애니메이션 작업에 이러한 제약 조건을 적용합니다. -
/fixing-motion-performance <파일>아래 모든 규칙에 따라 파일을 검토하고 다음을 보고합니다:- 위반 사항 (정확한 줄 또는 코드 조각 인용)
- 그 이유 (짧은 문장 하나)
- 구체적인 수정 방안 (코드 수준 제안)
명시적으로 요청되지 않는 한 애니메이션 라이브러리를 마이그레이션하지 마십시오. 기존 스택 내에서 규칙을 적용하세요.
사용 시기
다음과 같은 경우 이 가이드라인을 참조하세요:
- UI 애니메이션을 추가하거나 변경할 때 (CSS, WAAPI, Motion, rAF, GSAP)
- 버벅거리는 상호작용이나 전환을 리팩토링할 때
- 스크롤 연계 모션이나 스크롤 시 나타나는 효과를 구현할 때
- 레이아웃, 필터, 마스크, 그라데이션 또는 CSS 변수를 애니메이션할 때
- will-change, transform 또는 측정을 사용하는 컴포넌트를 검토할 때
렌더링 단계 용어집
- 합성(composite): transform, opacity
- 페인트(paint): color, borders, gradients, masks, images, filters
- 레이아웃(layout): size, position, flow, grid, flex
우선순위별 규칙 범주
| 우선순위 | 범주 | 영향 |
|---|---|---|
| 1 | 절대 하지 말아야 할 패턴 | 심각 |
| 2 | 매커니즘 선택 | 심각 |
| 3 | 측정 | 높음 |
| 4 | 스크롤 | 높음 |
| 5 | 페인트 | 중간-높음 |
| 6 | 레이어 | 중간 |
| 7 | 블러 및 필터 | 중간 |
| 8 | 뷰 전환 | 낮음 |
| 9 | 도구 경계 | 심각 |
빠른 참조
1. 절대 하지 말아야 할 패턴 (심각)
- 동일 프레임에서 레이아웃 읽기와 쓰기를 번갈아 수행하지 마십시오.
- 크거나 의미 있는 표면에서 레이아웃을 지속적으로 애니메이션하지 마십시오.
- scrollTop, scrollY 또는 스크롤 이벤트로 애니메이션을 구동하지 마십시오.
- 중지 조건이 없는 requestAnimationFrame 루프를 사용하지 마십시오.
- 각각 레이아웃을 측정하거나 변형하는 여러 애니메이션 시스템을 혼합하지 마십시오.
2. 매커니즘 선택 (심각)
- 모션에는 transform과 opacity를 기본으로 사용하십시오.
- 상호작용이 필요할 때만 JS 기반 애니메이션을 사용하십시오.
- 페인트 또는 레이아웃 애니메이션은 작고 격리된 표면에서만 허용됩니다.
- 일회성 효과는 지속적인 모션보다 더 자주 허용됩니다.
- 모션을 완전히 제거하는 것보다 기법을 낮추는 것을 선호하십시오.
3. 측정 (높음)
- 한 번 측정한 후 transform 또는 opacity를 통해 애니메이션하십시오.
- 모든 DOM 읽기를 쓰기 전에 일괄 처리하십시오.
- 애니메이션 중에 레이아웃을 반복적으로 읽지 마십시오.
- 레이아웃과 유사한 효과에는 FLIP 스타일 전환을 선호하십시오.
- 측정과 쓰기를 일괄 처리하는 접근 방식을 선호하십시오.
4. 스크롤 (높음)
- 가능한 경우 스크롤 연계 모션에 Scroll 또는 View Timelines를 선호하십시오.
- 가시성 및 일시 중지에는 IntersectionObserver를 사용하십시오.
- 애니메이션을 위해 스크롤 위치를 폴링하지 마십시오.
- 화면 밖에서는 애니메이션을 일시 중지하거나 중지하십시오.
- 스크롤 연계 모션은 큰 표면에서 지속적인 레이아웃이나 페인트를 유발해서는 안 됩니다.
5. 페인트 (중간-높음)
- 페인트를 유발하는 애니메이션은 작고 격리된 요소에서만 허용됩니다.
- 큰 컨테이너에서는 페인트가 많이 필요한 속성을 애니메이션하지 마십시오.
- transform, opacity 또는 position을 위해 CSS 변수를 애니메이션하지 마십시오.
- 상속된 CSS 변수를 애니메이션하지 마십시오.
- 애니메이션되는 CSS 변수의 범위를 로컬로 제한하고 상속을 피하십시오.
6. 레이어 (중간)
- 컴포지터 모션에는 레이어 승격이 필요합니다. 절대 가정하지 마십시오.
- will-change를 일시적이고 정밀하게 사용하십시오.
- 많거나 큰 승격된 레이어를 피하십시오.
- 성능이 중요한 경우 도구를 사용하여 레이어 동작을 검증하십시오.
7. 블러 및 필터 (중간)
- 블러 애니메이션은 작게 유지하십시오 (<= 8px).
- 블러는 짧고 일회성 효과에만 사용하십시오.
- 블러를 지속적으로 애니메이션하지 마십시오.
- 큰 표면에서 블러를 애니메이션하지 마십시오.
- 블러보다는 opacity와 translate를 먼저 선호하십시오.
8. 뷰 전환 (낮음)
- 뷰 전환은 내비게이션 수준의 변경에만 사용하십시오.
- 상호작용이 많은 UI에는 뷰 전환을 피하십시오.
- 중단 또는 취소가 필요한 경우 뷰 전환을 피하십시오.
- 크기 변경은 잠재적으로 레이아웃을 유발하는 것으로 간주하십시오.
9. 도구 경계 (심각)
- 명시적으로 요청되지 않는 한 애니메이션 라이브러리를 마이그레이션하거나 다시 작성하지 마십시오.
- 기존 애니메이션 시스템 내에서 이러한 규칙을 적용하십시오.
- 동일한 컴포넌트 내에서 API를 부분적으로 마이그레이션하거나 스타일을 혼합하지 마십시오.
일반적인 수정 사항
/* 레이아웃 쓰레싱: width 대신 transform을 애니메이션 */
/* 이전 */ .panel { transition: width 0.3s; }
/* 이후 */ .panel { transition: transform 0.3s; }
/* 스크롤 연계: JS 대신 scroll-timeline 사용 */
/* 이전 */ window.addEventListener('scroll', () => el.style.opacity = scrollY / 500)
/* 이후 */ .reveal { animation: fade-in linear; animation-timeline: view(); }
// 측정: 쓰기 전에 읽기를 일괄 처리 (FLIP)
// 이전 — 레이아웃 쓰레싱
el.style.left = el.getBoundingClientRect().left + 10 + 'px';
// 이후 — 한 번 측정하고 transform을 통해 애니메이션
const first = el.getBoundingClientRect();
el.classList.add('moved');
const last = el.getBoundingClientRect();
el.style.transform = `translateX(${first.left - last.left}px)`;
requestAnimationFrame(() => { el.style.transition = 'transform 0.3s'; el.style.transform = ''; });
검토 지침
- 먼저 심각한 규칙을 적용하십시오 (절대 하지 말아야 할 패턴, 도구 경계).
- 의도와 일치하는 가장 비용이 적게 드는 렌더링 작업을 선택하십시오.
- 기본이 아닌 선택의 경우 이를 정당화하는 제약 조건(표면 크기, 지속 시간 또는 상호작용 요구 사항)을 명시하십시오.
- 검토 시 이론보다는 실행 가능한 참고 사항과 구체적인 대안을 선호하십시오.
제한 사항
- 이 스킬은 작업이 위에서 설명한 범위와 명확히 일치할 때만 사용하십시오.
- 출력물을 환경별 검증, 테스트 또는 전문가 검토의 대체물로 취급하지 마십시오.
- 필요한 입력, 권한, 안전 경계 또는 성공 기준이 누락된 경우 중단하고 명확히 요청하십시오.