Anime.js for HyperFrames
HyperFrames는 animejs 런타임 어댑터를 통해 Anime.js 인스턴스를 seek할 수 있습니다. 컴포지션이 애니메이션 객체를 소유하고, HyperFrames가 시계를 소유합니다.
규약
- 컴포지션 초기화 중에 동기적으로 애니메이션이나 타임라인을 생성합니다.
- Anime.js가 자체 시계로 진행되지 않도록
autoplay: false로 설정합니다. - 반환된 모든 애니메이션이나 타임라인을
window.__hfAnime에 등록합니다. - 유한한 지속 시간(duration)과 반복 횟수(loop)를 사용합니다.
- 벽시계 시간, 네트워크 상태 또는 시드 되지 않은 난수에 기반하여 DOM을 변경하는 콜백을 피합니다.
어댑터는 등록된 모든 인스턴스에 대해 instance.seek(timeMs)를 호출하며, 여기서 timeMs는 HyperFrames 시간(밀리초)입니다.
기본 패턴
<script src="https://cdn.jsdelivr.net/npm/[email protected]/lib/anime.iife.min.js"></script>
<script>
const anim = anime({
targets: ".mark",
translateX: 280,
rotate: "1turn",
opacity: [0, 1],
duration: 1200,
easing: "easeOutExpo",
autoplay: false,
});
window.__hfAnime = window.__hfAnime || [];
window.__hfAnime.push(anim);
</script>
타임라인 패턴
<script>
const tl = anime.timeline({
autoplay: false,
easing: "easeOutCubic",
});
tl.add({
targets: ".title",
translateY: [40, 0],
opacity: [0, 1],
duration: 650,
}).add(
{
targets: ".accent",
scaleX: [0, 1],
duration: 450,
},
250,
);
window.__hfAnime = window.__hfAnime || [];
window.__hfAnime.push(tl);
</script>
모듈 빌드
ES 모듈 빌드를 사용하는 경우 어댑터는 인스턴스가 어떻게 생성되었는지 신경 쓰지 않습니다. 반환된 객체가 seek(), pause(), 그리고 가급적 play()를 노출하기만 하면 됩니다:
<script type="module">
import { animate } from "https://cdn.jsdelivr.net/npm/animejs/+esm";
const anim = animate(".chip", {
x: "18rem",
duration: 900,
autoplay: false,
});
window.__hfAnime = window.__hfAnime || [];
window.__hfAnime.push(anim);
</script>
좋은 사용 예
- Anime.js 문법이 간결한 작은 SVG 및 DOM 장식.
- seek 기반으로 만들 수 있는 가져온 Anime.js 예제.
- 동일한 레지스트리에 푸시되는 여러 개의 독립적인 마이크로 애니메이션.
사용자가 특별히 Anime.js를 요청하지 않는 한 복잡한 장면 시퀀싱에는 GSAP을 사용하세요. GSAP은 여전히 주요 HyperFrames 제작 경로입니다.
피해야 할 사항
autoplay를 Anime.js 기본값으로 남겨두는 것.- 명시적인
window.__hfAnime.push(...)대신anime.running자동 탐색에 의존하는 것. - 무한 루프. 컴포지션 지속 시간에서 유한한 반복 횟수를 계산하세요.
- 타이머, 프로미스, 이벤트 핸들러 또는 비동기 에셋 로드 후에 애니메이션을 생성하는 것.
검증
Anime.js를 사용하는 컴포지션을 편집한 후:
npx hyperframes lint
npx hyperframes validate
크레딧 및 참고 자료
- HyperFrames 어댑터 소스:
packages/core/src/runtime/adapters/animejs.ts. autoplay,pause(),seek()에 대한 Anime.js 문서: https://animejs.com/documentation/