HyperFrames를 위한 CSS 애니메이션
HyperFrames는 css 런타임 어댑터를 통해 CSS 키프레임 애니메이션을 탐색(seek)할 수 있습니다. 간단한 반복 모티브, 배경 모션, 쉬머, 글로우, 마스크 및 비순차적 장식에 사용하세요.
씬 연출에는 일반적으로 GSAP이 더 명확합니다. CSS 애니메이션은 모션이 하나의 요소에 속하고 고정된 지속 시간을 가질 때 가장 잘 작동합니다.
규약
- 런타임 초기화가 완료되기 전에 애니메이션 요소를 DOM에 넣으세요.
- 타이밍 요소에
data-start값을 지정하여 로컬 애니메이션 시간이 클립과 일치하도록 하세요. - 유한한
animation-duration과animation-iteration-count를 사용하세요. 음수 지연(negative-delay) 대체 방식은 WAAPI 기반 CSS 애니메이션이 없는 환경에서 무제한 지속 시간을 표현할 수 없기 때문입니다. - 탐색된 상태가 활성 모션 전후에 유지되도록
animation-fill-mode: both를 선호하세요. - 실제 시간(wall-clock) JavaScript, 호버 기반 상태, 사용자 이벤트에 의존하는 클래스 토글을 피하세요.
어댑터는 계산된 animation-name을 가진 요소를 감지하고, 가능할 때 브라우저의 Animation 핸들을 탐색(seek)하며, 그렇지 않으면 음수 animation-delay로 일시 중지하는 방식으로 대체합니다.
기본 패턴
<div
id="pulse-ring"
class="clip pulse-ring"
data-start="0"
data-duration="4"
data-track-index="2"
></div>
<style>
.pulse-ring {
width: 280px;
height: 280px;
border: 4px solid rgba(255, 255, 255, 0.7);
border-radius: 50%;
animation-name: pulse-ring;
animation-duration: 1200ms;
animation-timing-function: cubic-bezier(0.2, 0, 0, 1);
animation-iteration-count: 3;
animation-fill-mode: both;
}
@keyframes pulse-ring {
from {
opacity: 0;
transform: scale(0.82);
}
35% {
opacity: 1;
}
to {
opacity: 0;
transform: scale(1.18);
}
}
</style>
스태거 패턴
키프레임을 중복하지 않도록 CSS 사용자 정의 속성을 사용하세요:
<div class="clip dots" data-start="1" data-duration="3" data-track-index="3">
<span style="--i: 0"></span>
<span style="--i: 1"></span>
<span style="--i: 2"></span>
</div>
<style>
.dots span {
display: inline-block;
width: 18px;
height: 18px;
margin-right: 10px;
border-radius: 50%;
background: currentColor;
animation: dot-pop 900ms ease-out both;
animation-delay: calc(var(--i) * 120ms);
}
@keyframes dot-pop {
from {
opacity: 0;
transform: translateY(18px) scale(0.75);
}
to {
opacity: 1;
transform: translateY(0) scale(1);
}
}
</style>
적절한 사용 사례
- 반복 횟수가 알려진 장식적 루프
- 마스크, 글로우, 쉬머, 그레인, 미세한 시차 레이어
- 전체 JS 타임라인이 과도한 단일 요소 진입 효과
피해야 할 사항
- 브라우저가 탐색 가능한(seekable) WAAPI 기반 CSS 애니메이션 핸들을 제공하는지 확인하지 않은 상태에서의 무한 CSS 애니메이션. 가시적인 지속 시간을 포괄하는 유한한 반복 횟수를 선호하세요.
- 트랜스폼이 가능할 때
top,left,width,height같은 레이아웃 속성 애니메이션 - 호버, 포커스, 스크롤 또는 미디어 쿼리에 의존하는 렌더링에 중요한 모션 트리거
- 시작 후 애니메이션 클래스 변경. 다른 결정론적 타임라인이 해당 변경을 제어하지 않는 한 피하세요.
검증
CSS 애니메이션 구성을 편집한 후:
npx hyperframes lint
npx hyperframes validate
크레딧 및 참고 자료
- HyperFrames 어댑터 소스:
packages/core/src/runtime/adapters/css.ts - MDN CSS 애니메이션 문서: https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/animation
- MDN
animation-fill-mode: https://developer.mozilla.org/en-US/docs/Web/CSS/animation-fill-mode