HyperFrames용 CSS 애니메이션
HyperFrames는 css 런타임 어댑터를 통해 CSS 키프레임 애니메이션을 탐색할 수 있습니다. 간단한 반복 모티프, 배경 움직임, 광택(shimmer), 글로우(glow), 마스크, 비순차 장식에 사용하세요.
씬 연출(Scene choreography)에는 GSAP이 일반적으로 더 명확합니다. CSS 애니메이션은 모션이 하나의 요소에 속하고 고정된 지속 시간을 가질 때 가장 잘 작동합니다.
계약
- 애니메이션 요소를 런타임 초기화가 완료되기 전에 DOM에 배치하세요.
- 시간이 지정된 요소에
data-start값을 부여하여 로컬 애니메이션 시간이 클립과 일치하도록 하세요. - 유한한
animation-duration과animation-iteration-count를 사용하세요. 음수 지연 대체 방식은 WAAPI 기반 CSS 애니메이션을 지원하지 않는 환경에서 무한 지속 시간을 표현할 수 없기 때문입니다. animation-fill-mode: both를 선호하세요. 탐색된 상태가 활성 모션 전후에 유지됩니다.- 벽시계 JavaScript, 호버 트리거 상태, 사용자 이벤트에 의존하는 클래스 전환을 피하세요.
어댑터는 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 애니메이션. 가시 지속 시간을 포함하는 유한 반복 횟수를 선호하세요.
- 변형(transform)이 가능할 때
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