HyperFrames용 CSS 애니메이션
HyperFrames는 css 런타임 어댑터를 통해 CSS 키프레임 애니메이션을 탐색(seek)할 수 있습니다. 단순 반복 모티프, 배경 모션, 쉬머, 글로우, 마스크, 비순차 장식에 사용하세요.
씬 연출에는 GSAP가 일반적으로 더 명확합니다. CSS 애니메이션은 모션이 하나의 요소에 속하고 고정된 지속 시간을 가질 때 가장 잘 작동합니다.
규약
- 애니메이션 요소를 런타임 초기화가 완료되기 전에 DOM에 배치하세요.
- 시간이 지정된 요소에
data-start값을 부여하여 로컬 애니메이션 시간이 클립과 일치하도록 하세요. - 유한한
animation-duration과animation-iteration-count를 사용하세요. 음수 지연 폴백은 WAAPI 기반 CSS 애니메이션이 없는 환경에서 무제한 지속 시간을 표현할 수 없기 때문입니다. animation-fill-mode: both를 선호하여 탐색된 상태가 활성 모션 전후에 유지되도록 하세요.- 벽시계 자바스크립트, 호버 트리거 상태, 사용자 이벤트에 의존하는 클래스 토글을 피하세요.
어댑터는 계산된 animation-name을 가진 요소를 찾고, 가능한 경우 브라우저 Animation 핸들을 탐색하며, 그렇지 않으면 음수 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 타임라인이 과도한 간단한 단일 요소 진입.
피해야 할 것
- 브라우저가 탐색 가능한 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